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INTRODUCTION 


The User's Guide, B 1000 Series Generalized Message Control 
System (GEMCOS) Format Generator is written for Burroughs 
customer programmers who are writing application programs 
that require message formatting in an Advanced or Total 
GEMCOS environment. 


The guide contains instructions for the operation of the 
system's two format creation programs. It also covers the 
syntax and defaults of the commands used by the two 
programs. 


The B 1000 Series Format Generator is available on Burroughs 
B 1000 computers under the following style identification: 
B10O00 MCF. 


Section 1 of this manual provides an overview of the GEMCOS 
Format Generator System. Section 2 describes a 
nonintepretive formatting session using the Format Maker. 
Section 3 illustrates an intepretive formatting session with 
the Format Generator. A complete description of all Format 
Maker and Format Generator commands is included in Section 
4. The following are included in the appendices for each of 
the format creation programs: 


: The names and purposes of the B 1000 files used in 
format creation. 

: The system limits and defaults. 

° The error messages. 


The information in this manual can be supplemented from the 
following manuals: 


‘; User's Guide, B 1000 Series Generalized Message 
Control System (GEMCOS) (Relative to 7.0 Software 
Release), form 1163920. 


, B 1800/B 1700 Generalized Message Control System 
(GEMCOS) Formatting Guide, form 1106531. 


vil 


Capabilities Manual, B 1000. Series Generalized 
Message Control System (GEMCOS), (Relative to 7.0 
Software Release), form 1164001. | 


B 1000 System Software Operation Guide, form 
~1151982. : | 


viii 


SECTION 1 


OYSTEM OVERVIEW 


The B1000 Generalized Message Control System (GEMCOS) 


Format Generator product consists of two mutually 
independent formatting programs, one interpretive (Format 
Generator) and one noninterpretive (Format Maker). These 


programs are designed to free the GEMCOS programmer from 
most of the work involved in creating GEMCOS formats. 


Each program allows formats to be laid out (entered as 
literal text to create a screen image), tested, and stored. 
And each supplies updated formats to the "live" GEMCOS 
network from an on-line terminal without requiring that 
GEMCOS be brought down or that other processing be 
disturbed. 


Both programs are designed to run in the following 
environments: 


‘ Under the B 1000 GEMCOS MCS. 
: As free-standing application programs. 
‘ Without the supervision of an MCS. 


Note that if either program is run under the control of a 
GEMCOS MCS, it should be declared in the TCL as either a 
nonparticipating UTILITY or an ASSIGNMENT program. 


FORMAT MAKER PROGRAM 


The Format Maker program creates and maintains 
noninterpretive B 1000 GEMCOS on-line terminal formats 
interactively. The user can add, change, and delete formats 
in the Test Format file, then "update" them in the 
noninterpretive Live Format file. Because a noninterpretive 


format is stored essentially as it is seen on the terminal 
screen, formatted output messages can be presented with very 
little delay. 


Figure 1-1 shows a diagram of the processes and actions 
taken by the Format Maker. 


DISPLAY, LIST, TESTOUT 


Figure 1-1. Format Maker Diagram 


FORMAT MAKER FORMATS 


A Format Maker format describes how the parts of a message 
should be displayed on output to the terminal device. 
Because formats are laid out on the terminal screen, the 
user can create the necessary layouts without knowledge of 
the devices that send the data. However, since the Format 
Maker formats are stored as TD830 cursor-positioning 
strings, Format Maker output formats can only be created or 
used on a TD830-compatible terminal device. 


FORMAT GENERATOR PROGRAM 


The Format Generator program, like Format Maker, allows the 
user to lay out formats on an on-line B 1000 GEMCOS terminal 
screen. However, Since Format Generator stores its formats 
in the form of TCL formatting codes, formats can be designed 
for specific terminal device types. This is done simply by 
running the Format Generator program from an on-line 
terminal of the required type. 


The Format Generator program frees the GEMCOS programmer 


from concern with Transaction Control Language (TCL) 
requirements when describing simple formats. It also 
assumes most of the work required for creating complicated 
formats. At the end of a formatting session, the Format 


Generator program allows the user to save the TCL formatting 
specifications generated by the program during that session. 


Figure 1-2 shows a diagram of the processes and actions 
taken by the Format Generator. 


Figure 1-2. Format Generator Diagram 


FORMAT GENERATOR FORMATS 


A Format Generator format describes how the parts of a 
message should be handled from a terminal device (on input) 
or from an application (on output). Typically, this 
handling includes expanding, compressing, inserting, 
deleting, and rearranging fields, and translating data. 


A Format Generator format can also contain integrity checks, 
such as tests for all-numeric characters. On output, the 
programming features of the terminal device can be used to 


create more readable displays and to send device-independent 
data structures. 


Because the format layout is created by "painting," 
programmers can define their message layouts without 
knowledge of the devices which send and receive data. The 
appearance of the final message can be determined by a 


format, allowing the application programmer to disregard 
differences between terminals. 


The Format Generator builds a format type called a DISPLAY 
format. Its main function is to produce more readable 
program output. The DISPLAY format allows the application 
programmer to send out a device-independent data structure. 
The Format Generator then adds titles and rearranges data to 
create the terminal display. Without formatting, programs 
must specify arrangements for spacing, titles, and forms 
control. 


SELECTING THE APPROPRIATE PROGRAM 


Although the Format Maker is similar to the Format 
Generator, there are some important differences between the 
two. For example, because Format Generator interacts as it 
does with the TCL, it can create formats capable of 
inserting, substituting, or rearranging fields as data 
strings are fit into the pre-designed formats. Format Maker 
formats, being noninterpretive, offer a simpler, quicker 
alternative with a faster response time. 


The following differences should be considered in deciding 
whether a given format will be created using Format Maker or 
Format Generator: 


‘ Format Maker allows one user at atime, while 
Format Generator allows as many as 10 users on one 
copy of the program. 


° Format names used by the Format Maker can only be 
Six characters long. Format Generator names may be 
as long as 17 characters. 


‘ Format Maker formats cannot be described in the 
TCL. The format name must function as the message 
ID for that format. Format Generator formats can 
be described in the TCL. 


‘ A Format Maker format must be created and used on 
a TD830-compatible terminal. A Format Generator 
format can be used on whatever device type was 
used in its creation. 


tag The status line (line 25) of the terminal screen 
is used by the Format Maker, but not by the Format 
Generator. 


: Format Maker formats are processed | faster than 
Format Generator formats. 


USING INFORMATIONAL COMMANDS 


Both formatting programs offer information to the user 
through the following commands: 


. HELP 

: STATUS 
. TEACH 
: WHAT 


There are essentially only two different commands in this 
category, Since HELP and TEACH are synonymous, as are STATUS 
and WHAT. The HELP and TEACH commands inform the user of 
available commands) and their syntax. The STATUS and WHAT 
commands are used to obtain information about a particular 
station that is attached to the formatting program. Syntax 
information on each command is in Sections 3 and 5. 


SECTION 2 


FORMAT MAKER FORMATTING SESSION 


The Format Maker program creates noninterpretive GEMCOS 
output formats for use by a TD830-compatible terminal. 


Formats are stored as packed TD830 cursor-positioning 
strings. Because Format Maker formats are not designed to 
interact with the TCL, they cannot insert, substitute, or 
rearrange fields, as the Format Generator program can. 


However, because formats are already ina form usable by the 
TD830, the response time is reduced. 


A formatting session with its required commands is described 
in this section, including the following tasks: 


1. Initiating the program. 

2 Creating or modifying formats. 
om Testing formats. 

4. Updating format files. 

oe Saving or purging the work file. 
6. Activating new formats. 


FORMAT MAKER FILES 


The following files are used by Format Maker in a formatting 
session: 


: Test Format file. 
, Live Format file. 
: Library file. 


The Test Format file contains all the formats created or 
modified during the current formatting session. It is 


either saved or purged at the end of the session as 
specified by the user. 


One or more formats from the Test Format file can be 
transferred by Format Maker to the Live Format file for use 
by the MCS. The Live Format file can be updated at any time 
without requiring that the MCS be brought down. 


The Library Format file is a COBOL library containing the 
COBOL entries corresponding to each format field for which 
LIBRARY has been set equal to TRUE. These entries can be 
merged by the COBOL programmer into an application program. 


INITIATING FORMAT MAKER 


The Format Maker program can be initiated in one of two 
ways: 


: If not running under the control of a GEMCOS MCS, 
Format Maker is executed in the same manner that 
any application program is executed: 


EX GEMCOS/FORMMAKER <optional file equates> 


‘ If Format Maker is running under the control of a 
GEMCOS MCS, the GEMCOS EX network control command 
is entered from the user's’ station, and _ the 
following must be declared in the TCL. 


MAXASSIGNERS 
INTERFACE 


1. 
NONPARTICIPATION. 


Note that the terminal should not be in scroll mode when a 
formatting session is initiated. "?-" must be entered in 
home position to take the terminal out of scroll mode. 


The BYE command ends the formatting session and causes the 
Test Format file to be either saved or purged, as the user 
specifies. If no option is specified and the Test Format 
file is empty, Format maker will purge the file. If no 
option is specified and the Format Test file contains one or 
more files, the file will be saved. When Format Maker 
reaches end-of-job, it will list the following: 


: Test Format file name. 
: Whether it was saved or purged. 
: Library Format File name. 


BEGINNING A SESSION 


After Format Maker is initiated, a formatting session begins 
with the definition of the character to be used as the right 
forms mode delimiter. The default for this is the RS 
character (ASCII 30). If the WRITE command is to be used to 
produce a printed copy of a format, the right delimiter 
Character should match the contents of the TD830 register 


87. The forms mode right delimiter character becomes 
important for such features as bright highlighting or 
reverse video. See "Modifying a Format" later in this 


section. 


In the first screen of Figure 2-1, the program requests the 
delimiter character to be used. In the second screen, the 
user enters the delimiter character. 


WELCOME TO THE 6 1000 GEMCOS FORMAT GENERATOR FORMAT MAKER, MARK 2.0. 
ENTER OPTIONAL FORMS DELIMITER (1 CHARACTER)...DEFAULT IS (4). 


} WELCOME TO THE B 1000 GEMCOS FORMAT GENERATOR FORMAT MAKER, MARK 2.0. 
ENTER OPTIONAL FORMS DELIMITER (1 CHARACTER)...DEFAULT IS (<). 


Figure 2-1. Assigning the Right Delimiter. 


Once the delimiter character is defined, Format Maker sends 
a message indicating the start of the session. The program 
then waits for the receipt of the first command. 


Commands are entered ina free-form manner from anywhere on 
the terminal screen. However, if a command is not entered 


at home position, it must be preceded only by blanks. When 
the terminal is in Expecting Format Layout mode (explained 
in this section under "Creating a Format"), commands should 


be entered starting at the first character position on the 
screen. 


OS 


CREATING A FORMAT 


TO create a format, the FORMAT command must be issued. See 
Section 3 for syntax information. The FORMAT command places 
the terminal in Expecting Format Layout mode. When in this 
mode, the user can lay out the format as it should appear, 
or cancel the FORMAT command by entering IGNORE. 


Figure 2-2 illustrates the user's entry of the FORMAT 
command and the response by Format Maker. In the first 
screen of this figure, the format to be defined is named 
Custmr (six characters, as required by Format Maker). This 
format will be used to illustrate each of the steps 
discussed in this section. Note that the Custmr format is 
assigned the LIBRARY attribute. The default value for the 


LIBRARY attribute is FALSE. See "FORMAT" in Section 3 for 
more information. 


FORMAT CUSTOMER LIBRARY = T 


-T 
FORMSMODE -T 
LIBRARY =T 


wee EXPECTING FORMAT LAYOUT #=* 


Figure 2-2. Creating a Format 


At this point, the terminal must be cleared and the 
appropriate layout placed on the screen. Figure 2-3 shows 
the rough layout of the Custmr format both before 
translation and after the Format Maker response. Each pound 


sign (#) represents the screen position at which an 
alphanumeric character from a message sent to the terminal 
will be displayed. The pound sign characters are not shown 


on the screen when the format 1s in actual use. 


Laying out a format consists of entering all headings, field 
identification titles, and field delimiters on the screen. 
The only special character that may be entered is the pound 
sign (#), which indicates where alphanumeric data is to be 
displayed. This data is sent by an application program and 
will be merged into the format wherever the #'s occur. A 
maximum of 144 output fields may be entered for one format. 
An output field is a continuous string of pound signs. For 
example, "###-##-####" consists of three fields. 


As soon as the format layout is transmitted from home 
position or from some point after the last character of the 
format layout (transmission from anywhere else causes the 
format to be truncated), a format is created in the form of 
TD830 cursor-positioning strings. It is then ready for 
modification, testing, or transfer to the Live Format file. 


aa 


FELESEKSFEFEFFSEFETEF 
H##-##-8FEEE 

4/88/88 

H#HHSESS 


CUSTOMER NAME: ####¢#8¢##8d88068808 
ACCT. NUMBER: ##8-FF-FEREF 

DATE OF ACCT. #/#E/RF 

ACCT. BALANCE SRRESHKE 


FORMAT LAYOUT ACCEPTED 
# 


Figure 2-3. Creating a Format Layout 


While laying out a format, it may be desirable to end 
Expecting Format Layout mode to modify the format attributes 
or to display an existing format. This can be done by 
issuing the IGNORE command in the home position and may be 
done at any time prior to transmitting the format layout. 


Note that transmission of the IGNORE command at any place 
but home position will cause that portion of the displayed 
format that precedes the cursor on the screen to be entered 
in the Test Format file. Figure 2-4 illustrates the user's 
entry of IGNORE and Format Maker's response to the 
cancellation of a format. 


IGNORE 
CUSTOMER NAME: — #4 EIEEIEIEE IEEE ESERIES 
ACCT. NUMBER: HEE-HU- BUG H 


ACCT. BALANCE A EEE 
DATE OF ACCT. HA /RA/ ME 


FORMAT LAYOUT CANCELLED 
# 


Figure 2-4, Cancelling a Format 


MODIFYING A FORMAT 


The MODIFY command is used to make changes in an existing 
format. The first screen of Figure 2-5 shows. the user's 
entry of the MODIFY command to display the Custmr format. 
The second screen shows Format Maker's response. The third 
and fourth screens show the user's Change and and Format 
Maker's acceptance of the of the altered format. 


CUSTOMER NAME: MME EE TEETER TE SE AE SE aE ETE EE 
ACCT. NUMBER: dR — aS aE 

DATE OF ACCT.: E/T / PT 
ACCT. BALANCE: TRAE A AE 


wee EXPECTING FORMAT LAYOUT ** 


HEE EE EEE EAE SE AE SE SE SE SEE 
Ht — EHH TE 


CUSTOMER NAME: 
ACCT. NUMBER: 
DATE OF ACCT.: abd / MAE / TEA 
ACCT. BALANCE: BURG TE 
ACCEPTS BACK ORDERS: # 


CUSTOMER NAME: AAR AR AEE AE AE ARTE AE EAE ARTE AE ARE AE AEE 


ACCT. NUMBER: tHE — Hat dH 
DATE OF ACCT.: dat / Stat / TAT 
ACCT. BALANCE: ETT 
ACCEPTS BACK ORDERS: # 


FORMAT LAYOUT ACCEPTED 
# 


Figure 2-5. Modifying a Format 


Unlike the Format Generator program (which is discussed in 


Section 4), Format Maker has no LINE command to enter 
control characters which cannot be entered graphically 
(alphanumerically) on the’ screen. Instead, any control 
characters for reverse video, bright highlight, and 


underlining must be entered using the CTRL H sequences 
described in the TD830 manual. 


The end of a highlighted string is indicated by the right 
delimiter character that is defined at the beginning of the 
formatting session. If no right delimiter is used, the 
remainder of the line is highlighted. 


TCL formatting features that cannot be represented ina 
format layout (data translation, repetition of fields, and 
location specifiers) are not available in the Format Maker. 
However, these features may be be used in the Format 
Generator program (see Section 4). 


TESTING A FORMAT 


As soon as a format layout has been transmitted, it is ready 
to be tested using the TEST command. This can be done in 
one of two ways. The first way is to enter the TEST command 
with no message attached. The format will be displayed in 
forms mode as it will appear during actual use. No data 
will be shown in the fields of the format. 


The second way is to enter the TEST command with a single 
alphanumeric string attached (exact syntax may be found in 
Section 3). The format will be presented as in the first 
case, but data from the test string will be displayed. 
Figure 2-6 illustrates the testing of the Custmr format. 
The first screen shows the user's entry of the TEST command 
with data. The second screen displays the format with data 
applied as it appears ina "live" environment. 


To exit the forms mode, enter CTRL Q. 


TESTOUT CUSTMR “JOHN Q. SMITH 156266942103318400001 750" 


Figure 2-6. Testing a Format 


RETRIEVING A FORMAT 


The GET command duplicates an existing format from another 
format file for modification or transfer into alive 


environment. The format must already exist in the specified 
file. If no file is specified, an error message is 
returned. See "Creating a Live Format File" in this section 


for information on creating other format files. 


Upon successful completion of a GET command, the terminal 
displays a picture of the retrieved format with any previous 
modifications intact. The GET command does not insert the 
retrieved format in the Test Format file. However, by using 
the two-page capability of the TD830 terminal, a user can 
GET a format layout, switch pages to execute the FORMAT 
command, and switch back to transmit the source images as a 
new format. The result is two identical formats with 


a. TSE 


different names. The duplicate format can be modified as 
desired. | 


The first screen of Figure 2-7 shows the user requesting the 
Custmr format from the MCSFORMATS file. The second screen 
shows Format Maker's response. : 


GET CUSTOMER FROM MCSFORMATS 
CUSTOMER LOADED CLEAR «= T 
¢ 


Figure 2-7. Retrieving a Format 


DISPLAYING A FORMAT 


Two commands can be used to examine the current format 
layout. The first command, DISPLAY, sends the format layout 


to the terminal. If no format name is specified, the most 
recently accessed format is displayed. The second command, 
WRITE, sends the format layout to the line printer. Both 


commands are useful when a temporary or permanent display of 
the format is required. 


Figure 2-8 demonstrates the DISPLAY command. In this 
example, it 1S assumed that the Test Format file contains 
the Custmr format, as used in previous examples. 


CUSTOMER NAME: — dHFREIREEEEE REESE ARE AE aE 
ACCT. NUMBER: HA —B—FR ET 

DATE OF ACCT. abet / ab AE/ dE aE 

ACCT. BALANCE HPP EE 


CLEAR=T, FORMSMODEST, LIBRARY=F 


Figure 2-8. Displaying a Format 
UPDATING A FORMAT 


It is often desirable to modify a format in a live GEMCOS 
environment. This can be done by using the GET command to 
display a format from the Live Format file. Once the format 
layout has been modified, it must be copied back to the Live 
Format. file. This can be done by placing the modified 
format on the second page of the terminal display and 
entering the FORMAT command. With the terminal in Expecting 
Format Layout mode, the modified format can be displayed and 
transmitted. Once the new format has been tested, the 
UPDATE command transfers it to the Live Format file. 


The updated format, however, is not recognized by the MCS 
until the *UPD FORMATS command is entered from a GEMCOS 
control station. A maximum of 400 format updates can be 
performed before it is necessary to enter the *UPD FORMATS 
command. 


Example: 


It is necessary to modify one of the lines of the 
Custmr format in the GEMCOS format file 
GEMCOS/NONINTERPS. The steps involved are as follows: 


l. Display a format from the Live Format file by 
entering: | 


GET CUSTMR FROM GEMCOS /NONINTERPS 


2- Modify the format as needed and shift to the 
second page. 


3. Introduce the modified format into the Test 
Format file by entering the following: 


FORMAT CUSTMR 


Then bring the format to the front page for 
transmission. 


4. Transfer the format to the Live Format file 
using the UPDATE command: 


UPDATE TO GEMCOS/NONINTERPS CUSTMR 


oe Modify the header records of the Live Format 
file to allow the GEMCOS MCS access’ to the 
updated formats by entering the following at 
a GEMCOS control station: 


*UPD FORMATS 


TO Similarly modify any other format file, 
change the file name to GEMCOS/NONINTERPS 
then enter *UPD FORMATS from a GEMCOS control 
station. 


CREATING A LIVE FORMAT FILE 
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When Format Maker is initiated, it creates a test file with 
a record size of 1620 bytes and assigns it the name 
MCSNONFORM/<hhmm>, where <hhmm> is the current time 
represented according to the standard 24 hour clock. This 
file is identical to the Live Format file used by the GEMCOS 
MCS. If no Live Format file currently exists, one can be 
created by changing the name MCSNONFORM/ <hhmm> to 
GEMCOS/NONINTERPS. 


If it is necessary to add to or otherwise change an existing 
noninterpretive format file, the OPEN command should be 


used. This command closes the current test file and opens 
the specified file. Nothing need be done to the current 
file before opening a new file. If the current file has no 


formats, it will be purged. 


This section provides a complete description of Format Maker 
commands. "Railroad" syntax diagrams are used to describe 
syntax of these commands. An explanation of syntax 


the 


SECTION 3 


FORMAT MAKER COMMANDS 


conventions can be found in the B41000 £2Series 
Reference Manual. 


The following is a list of all the Format Maker commands. 


BYE 

DEBUG 
DELETE 
DISPLAY 
FORMAT 
FORMAT LAYOUT 
GET 

HELP 
IGNORE 
LIST 
MODIFY 
NULL INPUT 
OPEN 
STATUS 
TEACH 

TEST 
UPDATE 
WHAT 

WRITE 


BYE 


— PURGE - 
~ SAVE --| 


Semantics: 


The BYE command terminates the user's current formatting 
session. If BYE PURGE is entered, the test file is purged. 
If BYE SAVE is entered, the test file is saved. If no 
option is specified and the Test Format file contains no 
formats, the file is purged. If no option is specified and 


the Test Format file does contain formats, the file is 
Saved. 


Example: 


BYE SAVE 


eS 


DEBUG 


Semantics: 


The DEBUG command is used as a "toggle" which alternately 
sets and resets debugging logic built into the Format Maker. 
The DEBUG command does not affect the development of formats 
but is designed to help diagnose difficulties within actual 
Format Maker code. 


When the debugging logic is invoked, the following 
information is written to a printer file: 


‘ A monitor of all procedures entered, including 
pertinent data for that procedure. 

; A program dump. This occurs whenever the Format 
Maker encounters a serious or fatal error. 


Example: 


DEBUG 


DELETE 
Syntax 
os (DELETE. S32 o%c"= SLOLMea tS eS S234 SH Se SS Se ee 
Semantics: 


The DELETE command is used to delete formats from the Test 
Format file. If, after deletion, the STATUS or WHAT command 
is used, no current format will be listed. 


Example: 


DEL OF23 


DISPLAY 


Syntax: 


-- DISPLAY ------------------------------------------------ 


|-<format name>-| 


Semantics: 


The DISPLAY command is used to display the current format or 
the specified format on the terminal. If no format name is 
specified, the current format is displayed. If there is no 
current format, an error message is returned. The format's 
attributes are displayed on the status line (line 25). 


Example: 


DISPLAY FORM51 


FORMAT 


Syntax: 


-- FORMAT --<format name>---------------------------------- | 


7 CLEAR eT TRUE ~ 
|- FORMSMODE -| |- FALSE -| 
| | - 

|- LIBRARY ---| 


Semantics: 


The FORMAT command is used to create a blank format, assign 
attributes to that format, and place the terminal in 
Expecting Format Layout mode. A format name can bea 
maximum of six characters in length. The format attributes 
have the following meanings: 


‘ CLEAR inserts the contents of the CLEAR define at 
the beginning of the format. The default value of 
the CLEAR define is 4"0C". The default value for 
the CLEAR attribute is TRUE. 


, FORMSMODE inserts the contents of the FORMSMODE 
define at the end of the format. The default 
value of the FORMSMODE define is 4"27E6". The 
default value of the FORMSMODE attribute is true. 
Any allowable characters are acceptable as forms 
characters. The symbols US, GS, and FS may be 
used to start a data field, and the RS symbol may 
be used to end a data field. 


. LIBRARY causes the Format Maker to produce a COBOL 
library corresponding to the output fields 
described in the format. The COBOL library will 
have a "01" level with the format name followed by 
"-—RECORD-". The individual fields (05 levels) 
will be of the form: 


<format name>-<line #>-<field # on line>. 


— 


Unless there is an attribute error found in the input, the 
FORMAT command always leaves the terminal in an Expecting 


Format Layout mode. This means that a format has been named 
and Format Maker is now expecting a layout of the format in 
the next transmission. Once the terminal is in Expecting 


Format Layout mode, the user must do one of three things: 


‘ Clear the screen, layout a format on the screen, 
and transmit the format layout. 


; Enter IGNORE in home position, which removes the 
terminal from Expecting Format Layout mode. Then 
enter another command, Or start over with a new 
format name and attributes. 


; Enter DISPLAY, which displays a previously created 
format layout for correction and leaves’ the 
terminal in an Expecting Format Layout mode. 


To determine if the terminal 1S in an Expecting Format 
Layout mode, a STATUS or WHAT command can be entered without 
changing or affecting the current format or terminal status. 


Examples: 


FORMAT FMT1 
FORMAT SFO9 CLEAR = F FORMSMODE=TRUE 


The format layout 
laid out by the 
(MCSNONFORM) when 
mode. — 


See Section 2 for 


FORMAT LAYOUT 


is not a command. It is simply the format 
user and sent to the Test Format file 
the terminal is in Expecting Format Layout 


an explanation of how to lay out a format. 


GET 


Semantics: 


The GET command is used to retrieve a format from a 
noninterpretive format file. The format will be displayed 
on the user's terminal. The format does not become the 
current format, but is displayed only for viewing purposes. 


Example: 


GET FORMO2 FROM FORMFILE/AP ON USERPAC 


HELP 
Syntax: 


---- HELP ------ -~---------------------------------- -------- | 
| - | | | 


|- TEACH -| |-<any valid Format Maker command>-| 


Semantics: 


The HELP command is used to obtain a list of valid Format 


Maker commands or to learn the syntax of a particular 
command. — | 


Example: 


HELP 


IGNORE 


Syntax: 


-- IGNORE ------------------------------------------------- 


Semantics: 


The IGNORE command terminates the command that is in 
progress. The IGNORE command can be used only when the 
terminal is in an Expecting Format Layout’ mode. Upon 
receipt of this command, the terminal is taken out of 
Expecting Format Layout mode, and another command can be 
entered. See Section 2 for more detail. 


This command must be entered starting at the first position 
on the terminal, and IGNORE must be the only word entered. 


Example: 


IGNORE 


Semantics: 


The LIST command displays’ the names of all formats in the 


test file on 
in the list. 
displayed in 
can fit on 
displayed. 

Maker causes 


Example: 


LIsT 


the terminal. Deleted formats are not included 

If there is a current format, it will be 
reverse video. Should there be more names than 
one page, the heading "---MORE---" will be 
Transmitting a blank character to the Format 
the next screen of names to be displayed. 


MODIFY 


Syntax: 


-- MODIFY --<format name>---------------------------------- | 


|- CLEAR --------- TRUE --| 

_ | 
|—- FORMSMODE -| |- FALSE -| 
|—- LIBRARY ---| 


Semantics: 


The MODIFY command changes an existing format and/or its 


attributes. Attributes not specified will remain the same. 
After entry of this command, the terminal will be placed in 
Expecting Format Layout mode. The user must then enter one 


of the following: 


‘ The modified format layout. 

; IGNORE - to get out of Expecting Format Layout mode. 
; DISPLAY - to display the current format. 

‘ STATUS - to see the current status. 


Even if only the attributes are to be changed, the format 
layout still must be transmitted. 


Examples: 


MODOFY OEOL 
MODIFY FORMI1 LIBRARY=T 


NULL INPUT 


Null input is not a command. It is used to receive the next 
screen of requested information after a LIST command is 
entered. A null input consists of a string of one or more 


blanks transmitted from home position. 


Example: 


<one space> 


OPEN 
Syntax: 


-~- OPEN --<file name>-------------------------------------- 


|- ON <pack name> -| 


Semantics: 


The OPEN command opens another noninterpretive format file 
and closes the current Test Format file. If the current 
test file has no formats, it is purged; otherwise it is 
Saved. The file name specified in the OPEN command must be 
a valid Format Maker format file. This command can be used 


to add formats to an existing file or modify an existing 
file. 


Example: 


OPEN MCSTESTFOR/0124 ON GEMPAC 


STATUS 


Syntax: 


-Se= STATUG soeceoccee ence oes oon See eee eee eee ese 
| --- | 
|- WHAT ---| 


Semantics: 


The STATUS command is used to obtain information about a 
particular station that is attached to Format Maker. The 
information obtained using the STATUS command includes: 


: Terminal width and length (always 80 by 24). 
‘ Current DEBUG setting. 

, Name of the current format (if any). 

. Name of the current Test Format file. 


: Number of the formats in the Test Format file. 


, Number of format updates that were done in this 
session. 


‘ Number of formats that were deleted in this 
session. 


‘ Last command entered. 


If a STATUS command is entered while the terminal is in an 
Expecting Format Layout mode, the status report includes the 
name of the new format to be entered into the Test Format 
file and displays the message: EXPECTING FORMAT LAYOUT. 
While in this mode, the STATUS command must be entered 
Starting at the first position on the terminal, and STATUS 
must be the only word entered. The STATUS and WHAT commands 
are synonymous. 


Example: 


STATUS 


TEACH 


Semantics: 


The TEACH command is used to obtain a list of valid Format 
Maker commands or to learn the syntax of a particular 
command. 


Example: 


TEACH 


Syntax: 


-- TESTOUT --<format name>---------------~------~+-+---------- 


|- " <string> " -| 
Semantics: 


The TEST command allows a format to be applied toa test 


message, and to have the resulting formatted message 
returned to the terminal. The test message is a character 
string set off by quotation marks, such as: "12xXYZ". Note 


that, unlike the Format Generator program, Format Maker only 


allows the entry of a single string, set off by quotation 
marks. 


If too much or not enough test data is entered, a warning 
message is sent to the terminal's status line after the test 


message is applied to the format. If no test data is 
entered, the format is applied to a blank message, as ina 
forms request ina "live" GEMCOS environment. Since Format 


Maker creates only output formats, the TESTIN command used 
by Format Generator is not used by Format Maker. 


Examples: 


TEST FAl "TEST DATA" 
TESTOUT OEOl1 
TESTOUT 148 "1234567890" 


UPDATE 


Syntax: 
| SSS S> Bo ig ce ge | 
| | 
-- UPDATE ~-------2----------~----------------+------------- 
-——- | | | | 
l|- To <file name> -| |-<format name>-| 
<file name> 
--<multi-file ID>------------------------------------------ 
| | | | 
|- / <file ID> -| |- ON <pack ID> -| 


Semantics: 


The UPDATE command is used to place one or more test formats 
into the live noninterpretive format file. The formats may 
be existing formats or new additions to the other file. 
This command is only valid if the’ Format Maker is run in 
update mode (SWO = 0). 


If no file name is specified, the current live GEMCOS format 
file named GEMCOS/NONINTERPS is_ used. Otherwise, the 
specified file is updated. If no formats are specified, all 
formats are updated. Otherwise, only the specified formats 
are updated. 


As with interpretive formats, the updated formats do not 
actually become live until the user enters the following 
GEMCOS command from a GEMCOS control station. 


*UPD FORMATS 
Examples: 


UPDATE 
UP TO NONFORMS/PAYROLL ON PACK4 FORMO1, F8 
UPDATE FARO], FARO3, FARO6 


WHAT 


l- sTatus -| 


Semantics: 


The WHAT command uses the same syntax and returns the same 
information as the STATUS command. 


WRITE 


Syntax: 


-- WRITE -------------------------------------------------- | 


|-- FORMATS --| 


Semantics: 


The WRITE command causes the current format or all formats 
in the test file to be written to the line printer. 


Examples: 


WR 
WRITE ALL FORMATS 


SECTION 4 


FORMAT GENERATOR FORMATTING SESSION 


The Format Generator program creates input and output 
formats for use by terminals within a GEMCOS network. Each 
format is compiled into a set of GEMCOS TCL formatting codes 
("op" codes), each 2-digit number of which refers toa 
separate formatting feature. When a compiled format is 
called by an application program, it is translated into a 
form usable by the terminal. Format Generator programs are 
able to insert, substitute, and rearrange the fields of a 
message sent through it. 


A formatting session with its required commands is described 
in this section, including the following tasks: 


: Initiating the Format Generator program. 
‘ Creating and modifying a format. 

: Compiling the format. 

‘ Testing the format. 


; Transferring the format to the Live Format file. 


The following file manipulations related to a formatting 
session are also described: 


: Modifying the TCL Work File record. 
‘ Merging the TCL Work File records. 
‘ Saving the TCL Work File. 


FORMAT GENERATOR FILES 


The following files are used during a session: 


‘ TCL Work File. 

; Format Layout file. 
‘ Test Format file. 

, Defines file. 

. Live Format file. 


The TCL work file contains the TCL source images for formats 


and functions. It is built by entering sequenced source 
Statements, or by translating the Format Layout file. The 
TCL work file is purged at the end of a session. However, 


the TCL work file can be saved to disk at any time during 
the session. 


The Format Layout file contains a picture of the current 
format that is broken down into lines based on the width of 


the terminal. It is modified by creating or accessing a 
format. The Format Layout file is purged at the end of a 
session. 


The Test Format file contains all the formats and functions 
created during the current session. It is modified by 
compiling formats and functions and is purged at the end of 
a session. 


The Defines file contains a list of character defines that 
can be implemented by the user. A default Defines file is 
supplied with the Format Generator program, but the user can 
create a new one using the DEFINE command. 


The Live Format file contains those formats currently 
accessible to the GEMCOS MCS. 


INITIATING THE FORMAT GENERATOR PROGRAM 
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The Format Generator program can be initiated in one of two 
ways: 


; If not running under the control of a GEMCOS MCS, 
the Format Generator is executed in the same 
manner that any application program is executed: 


EX GEMCOS/FORMGEN <optional file equates> 
: If running under the control of a GEMCOS MCS, the 
GEMCOS EX network control command is entered from 


the user's station. The following must be true: 


MAXASSIGNERS = 10. 
INTERFACE NONPARTICIPATION. 


Note that the terminal should not be in SCROLL mode when a 
formatting session is initiated. 


After the Format Generator program goes to beginning-of-job 
(BOJ), ait waits to receive input from the station. Upon 
receipt of any input from the station, the program sends a 
message indicating the start of a session. 


A maximum of 10 stations can use the same copy of the Format 


Generator program concurrently. The actual number of 
stations attached to a single copy depends on the number of 
stations contained in the opened remote file. Multiple 


copies of the Format Generator can be run simultaneously 
since all workfiles are uniquely identified. 


BEGINNING A FORMATTING SESSION 


After the Format Generator program greeting is received, the 
user can begin formatting with the entry of the first 
command. Commands are entered ina free-form manner from 
anywhere on the terminal screen, except when the terminal is 
in Expecting Format Layout mode. When the terminal is in 
Expecting Format Layout mode, commands should be entered 
starting at the first character position on the screen. 


The BYE command ends the formatting session and purges the 
following: 


‘ The current TCL work file. 
; The Format Layout file. 
; The Test Format file. 


See Section 5 for information on command syntax. 
CREATING A FORMAT 


To create a format, the FORMAT command must be issued. This 
places the terminal in Expecting Format Layout mode. When 
in this mode, the user can lay out the format as it should 
appear, or cancel the FORMAT command. A FORMAT command does 
not alter the contents of the Format Layout file, but does 
Clear the terminal screen and prepare the Format Generator 

program to receive the anticipated format layout. Figure 


4-1 illustrates the user's entry of the FORMAT command and 
the response by the Format Generator. In Figure 4-1, the 
CLEAR and FORMSMODE attributes were selected. 


FORMAT CUSTOMER CLEAR = T FORMSMODE - T 


FORMAT CUSTOMER 
CLEAR «TJ 
FORMSMODE =T 
RESIDENT =F 
AUTOCOMPILE -F 


one EXPECTING FORMAT LAYOUT ## 


Figure 4-1. Creating a Format 


Yer SS 


At this point, the terminal must be cleared and _ the 
appropriate layout must be placed on the screen. 


Laying out a format consists of entering all headings and 
field indentification titles, positioning forms characters, 
etc., On the screen. Pound signs (#) and ampersands (&) are 
used to indicate where data is to be displayed or entered. 


A pound sign (#) indicates where one character of 
alphanumeric data should be displayed, and an ampersand (&) 
indicates where a character of numeric data should be 
displayed. The carriage return character (ii) indicates the 
end of significant data on a line. The user can insert this 
character on any line to indicate the end of information on 
that line. In the absence of this character, Format 
Generator automatically determines the end of significant 
data for that line. 


The format 1S created upon transmission and becomes 
available for subsequent processing. The Format Layout file 
now reflects the format layout just received. Any 


information previously stored in the Format Layout file is 
removed. 


Figure 4-2 shows the rough layout of the Customer format 
(which will be used for illustration throughout this 
section), both before transmission and after the Format 
Generator response. 


CUSTOMER NAME: SEGESESERESESSSTERES 
ACCT. NUMBER: Oi Bib Bb 

DATE OF ACCT: B/E IE 

ACCT. BALANCE: Ctibtttati 
ACCEPTS BACK ORDERS: & 


CUSTOMER NAME: SFFFLSEFELSSFFFFESFTESE 


ACCT. NUMBER: BE0- 85-8885 
DATE OF ACCT.: BOVEE/ES, 
ACCT. BALANCE: 68866855, 


ACCEPTS BACK ORDERS: & 
FORMAT LAYOUT ACCEPTED 
# 


Figure 4-2. Creating a Format Layout 


While creating a format, it may be desirable to end 
Expecting Format Layout mode to carry out some other 
operation. This can be done by issuing the IGNORE command 
any time prior to transmitting of the format layout. Figure 
4-3 illustrates the user's entry of IGNORE and the Format 
Generator's response to the cancellation of a format. 


IGNORE 
CUSTOMER NAME: S###88SSSS8 882222222 
ACCT. NUMBER: BSB-BS- BBS. 


ACCT. BALANCE 6B/EB/EL 
DATE OF ACCT. CSSSSESS. 


Figure 4-3. Cancelling a Format 


MODIFYING A FORMAT 


It is not always possible to lay out in Expecting Format 
Layout mode everything required in a format. Certain 
terminal control characters cannot be entered graphically 
(alphanumerically) on the screen. In addition, there are 
certain TCL formatting features, such as translation, 
repeats, and location specifiers, that cannot be represented 
in a format layout. These format additions are inserted 
into the format using the LINE command. 


yb 
40; 
oJ 


CONTROL CHARACTER INSERTION 


Figure 4-4 illustrates how to insert control characters 
using the LINE command. The first screen shows the user's 
first entry, a request to display the current information on 
line 2. The second screen is the Format Generator's 
response. The second line of this screen indicates all 


literals oon that line. The third line indicates the data 


characters in the message. The third screen shows 
information added by the user in order to insert the 
required control characters. The fourth line of this screen 
indicates where control strings are to be added. The fifth 


line displays the control strings used. For a break-down of 
this exchange, see the following table. 


Screen Line Explanation 
Screen 1] Line l The user's request to display 


current information from line 2 
of the format. 


Screen 2 Line 2 Format Generator returns the 
literal characters from line 2 
of the format. 


Line 3 Data characters in the message 
of the format. 


Screen 3 Line 4 Pointers added by the user to 
insert control strings. The 
LINE causes a control string to 
be inserted immediately before a 
left angle bracket (<) or 
immediately after a right angle 
bracket (>). 


Line 5 4"3F" is an example of a control 
string, inserted before the left 
angle bracket. 


A semicolon indicates the end of 
each control string (optional 
for the last control string 
specified). 


an 27", CK" is an example of 
another control string, inserted 
after the right angle bracket. 


Screen 4 Line 6 Format Generator's response to 
the control character insertion. 


The fourth screen is the Format Generator's response to the 
user's control character insertion. 


Figure 4-4. Inserting Control Characters 


LOCATION SPECIFIERS (REMAPPING) 


When the desired field order on a terminal is different from 
the order declared by the program, or when fields are 
skipped, message remapping is required. When remapping, it 
is often helpful to write out the program message layout as 
in the following COBOL example: 


Ol CUSTOMER-RECORD. 


05 CUST-NAME PIC X(20). 
05 CUST—ACCOUNT-NUM. 
10 ACCT-REGION-NUM PIC 9(3). 
10 ACCT-BRANCH-NUM PIC 9(2). 
10 ACCT—NUM PIC 9(6). 
05 CUST-ACCOUNT-DATE. 
10 CUST-ACCT-YEAR PIC 9(2). 
10 CUST-ACCT-MONTH PIC 9(2). 
10 CUST-ACCT-DAY PIC 9(2). 
05 CUST-ACCOUNT-BALANCE PIC 9(8). 


Two memory areas are maintained for every message processed 


through the formatting mechanism. The first contains the 
message as it appears on the terminal (the external 
message). The second contains the message as it appears in 


the program record area (the internal message). 


Each area has a pointer associated with it. These are the 
external message area pointer (external pointer) and the 
internal message area pointer (the internal pointer). Asa 
field or literal is processed, both pointers are advanced as 
characters are moved from one area to the other. Both 
pointers are initially set to zero. As each character ina 
message is processed, both pointers are advanced by one 
position. | 


Data can be rearranged by moving the internal pointer from 
one field to another. To adjust the setting of the internal 
pointer, a location specifier ("at" sign (@)) is used with a 
signed or unsigned integer. When an unsigned integer is 
used, the internal pointer is adjusted to the absolute 
position indicated by the integer (one relative). When a 
Signed integer is used, the internal pointer is adjusted in 
the direction of the sign relative to its present position. 


The following are two examples: 


@3 Moves the internal pointer to the third character 
position in the message (absolute remapping). 


@-16 Moves the internal pointer 16 characters back 
(relative remapping). 


When remapping is required, the first step involves creating 
a regular format layout with the fields as they are to 
appear on the terminal. The LINE command must then be used 
to identify where the internal pointer must be adjusted to 
accomplish remapping. 


Figure 4-5 shows how to alter the DATE OF ACCT fields’ so 
that CUST-ACCT-DAY and CUST-ACCT-DAY are displayed before 
CUST-ACCT-YEAR on the terminal. The location pointer is 
first moved forward two positions to access CUST-ACCT-MONTH 
and CUST-ACCT-DAY, moved back six positions to extract 
CUST-ACCT-YEAR, and then moved forward four positions for 
the next field. 


LINE 3 


DATE OF ACCT.: / + 


O& Oo Si 
< « < 


@+2; O-6; Ora 


Figure 4-5. Relative Remapping 


Figure 4-6 accomplishes the same end as Figure 4-5 
functionally, but absolute remapping is used instead of 
relative remapping. The location pointer is first moved to 
position 34 to access the month and day, then moved back to 
position 32 to extract the year, then moved to position 38 


for the next field. All character positions are _ one 
relative. 


4-12 


Figure 4-6. Absolute Remapping 


4-13 


TRANSLATION TABLES - TCL FUNCTIONS 
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A function is a translation table which can be referred to 
by a format. Refer to the B 1000 GEMCOS Reference Manual 
for a discussion of functions. To use a function, it must 
first be declared, using the SEQUENCE command, and compiled, 
using the COMPILE command. Refer to "Compiling a Format" 
and "Modifying the TCL Work File" in this section for an 
explanation of this process. See Section 5 for command 
syntax. | 


Functions are inserted into a format using the LINE command, 
as in the previous examples. In Figure 4-7, the program 
sends the ACCEPTS BACKORDERS field as a one-byte integer, 
either 0Oorl1. However, it is desired to display the words 
NO or YES instead. Assuming the function BOOLEAN’ was 
previously compiled, this line insertion accomplishes’ the 
required translation. 


When functions are inserted in this manner, it is necessary 
to allow room for inserting the characters of the function. 
All information to the right of the location specifier is 
shifted to the right by the length of the function. In 


Figure 4-7, at least six spaces are required at the end of 
the line. 


Ao eR 


Figure 4-7. Line Insertion - TCL Function 


COMPILING A FORMAT 


A format can be compiled at any time after a format layout 
is received. The compilation of a format is a two-step 
process. The first step is to translate the Format Layout 
file to TCL source images. These images are put in the TCL 
work file. The second process is to compile these TCL work 
file images. The resulting format is stored in the Test 
Format file. Compiling can be manual or automatic. This is 
determined by the AUTOCOMPILE attribute of the FORMAT 
command. 


If AUTOCOMPILE is set (or allowed to default) to FALSE, then 
compilation is manual. In this case, the user must enter 
the commands for translation (TRANSLATE) and compilation 
(COMPILE <format name>) manually, after the format layout is 
accepted. 


If AUTOCOMPILE is set to TRUE, then compilation follows 


automatically. After the format layout is transmitted and 
accepted by the Format Generator, the format is 
automatically translated and compiled. The user is informed 


that the format has been translated and compiled. 


Whenever translation is performed, the TCL source images are 


added to the end of the TCL work file. If the format 
already exists in the work file, it is removed. If the 
compile contains errors, the errors are displayed on the 


terminal, and the compile is stopped before completion. 


Figure 4-8 illustrates automatic compilation of the format 
Customer starting with the format layout. Assume 
AUTOCOMPILE was set to TRUE in the FORMAT command. The 
first screen shows the user's entry; the second indicates 
that the format layout was accepted. The third indicates 
that translation is complete, and the fourth tells the user 
that the compilation was completed successfully. 


4 - 16 


SFEFEFSEFESFEFEFFFFESF 
88.585 8858. 


CUSTOMER NAVE: SFEEFETLSE LETS SSIS EEE 
ACCT. NUMBER: 
DATE OF ACCT: 
ACCT. BALANCE: 
ACCEPTS BACK ORDERS: & 
FORMAT LAYOUT ACCEPTED 


CUSTOMER NAME: 
ACCT. NUMBER: 
DATE OF ACCT.: 
ACCT. BALANCE: 
ACCEPTS BACK ORDERS: & 
FORMAT LAYOUT ACCEPTED 


CUSTOMER TRANSLATED 


FHFFFFERFFSFLFFHKESE 


CUSTOMER NAME: SSEFFEFFESTEFERS FESS 
ACCT. NUMBER: 
DATE OF ACCT:: 68/68/85. 
ACCT. BALANCE: SLSAABAS, 
ACCEPTS BACK ORDERS: & 

FORMAT LAYOUT ACCEPTED 
CUSTOMER TRANSLATED 


CUSTOMER COMPILED 
e 


Figure 4-8. Automatic Compilation of a Format 


TESTING A FORMAT 


Once a format is compiled into the Test Format file, it can 


be tested. A format can be tested as an input or an output 
format. A format directed to aterminal is an output 
format. Data can be supplied for the format, or it can be 


treated as a forms request (for example, no data). 


Figure 4-9 illustrates testing the Customer output format. 
The first screen shows the user's entry of the TESTOUT 
command with data. The second screen displays the format 
with data applied as it appears ina "live" environment. 


TESTOUT CUSTOMER “JOHN Q. SMITH 
"1532669421" “800331" “00001750" “1° 


Figure 4-9. Testing a Format 


RETRIEVING A FORMAT 


An existing format can be retrieved for subsequent 
processing by using the GET command. A format can be 
retrieved from either the user's Test Format file or from 
any GEMCOS format file. To do this, a format must already 
exist in the specified file. The default file is the Test 
Format file. Upon successful completion of a GET command, 
the Format Layout file contains a picture of the retrieved 
format with any necessary line insertions already made. 


The GET command is used mainly for testing and modifying 
existing formats. However, by translating the format layout 
after executing a GET command, a copy of the TCL source 
images for the retrieved format can be obtained. 


Figure 4-10 illustrates retrieving the Customer format from 
the Live Format file MCSFORMATS. This format can now be 
compiled into the Test Format file and tested. As shown, 
this format was originally compiled with a clear-screen 
control character. 
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GET CUSTOMER FROM MOSFORMATS 


GET CUSTOMER FROM MCSFORMATS 
CUSTOMER LOADED CLEAR = T 
é 


Figure 4-10. Retrieving a Format 


If the screen size of the user's terminal is not 24 lines by 
80 characters, it is necessary to inform the Format 
Generator of the terminal's dimensions. This is so the 
Format Generator can allocate carriage returns correctly and 
compute line boundaries accurately. The TERMINAL command is 
used to accomplish these changes. 


Figure 4-11 illustrates the use of the TERMINAL command to 
inform the Format Generator that the user's terminal isa 
TD700. Since the screen size of that terminal is 8 lines by 
32 characters, the user's entry on screen 1 accomplishes the 
necessary reassignment. Screen 2 shows the Format 
Generator's response to this command. The last line of the 
response indicates that the user is currently using the 
system Defines file. 


TERM LINES = 8 WIDTH = 32 


Figure 4-11. Changing Terminal Attributes 


DISPLAYING A FORMAT 


Two commands can be used to display the current contents of 
the Format Layout file. The first command, DISPLAY, sends 
the format layout to the terminal. The second command, 
WRITE FORMAT, sends the format layout to the line printer. 
In both cases, only the literals and data are displayed. 
Line-insertion information is not displayed with these 
commands. These commands are useful when a temporary or 
permanent display of the format is required. 


Figure 4-12 demonstrates the DISPLAY command. In this 
example, it is assumed that the Format Layout file contains 
the format Customer, as in previous examples. 


SHFFFFLESTEFELTETSERSE 
888-86 8888. 

88/88/88. 

CASLSSAS. 


& 


Figure 4-12. Displaying a Format. 
UPDATING A FORMAT 


It is often desirable to modify a format from a live GEMCOS 
network while the MCS is running. Once a format is compiled 
into the user's Test Format file, the update mechanism 
allows the user to modify any format in any GEMCOS format 
file whether or not the MCS is running. The UPDATE command 
Or the update feature of the COMPILE command takes a 
compiled format from the user's Test Format file and places 


it in any Live Format file, provided the format exists in 
the specified live file. 


An example of the update process follows: 


It is necessary to modify one of the lines of the 


Customer format in the GEMCOS format file MCSFORMATS. 
The steps involved are: 


ee Get the format from the GEMCOS format file 
and convert it into a format layout. 

2. Modify the line in guestion. 

3% Translate and compile the format. 

4. Transfer the format back to the live format 
File. 


These steps use the following commands: 


eer GET CUSTOMER FROM MCSFORMATS 

2. <LINE command to modify line in gquestion.> 
os TRANSLATE 

4. COMPILE CUSTOMER 

os UPDATE TO MCSFORMATS CUSTOMER 


This updated format becomes available to the live 
GEMCOS network when the GEMCOS network control command 
UPDATE (UPD) is executed through the GEMCOS MCS. Note 
that for this example, the COMPILE and UPDATE commands 
could be replaced with the following command: 


COMPILE UPDATE TO MCSFORMATS CUSTOMER 


MODIFYING THE TCL WORK FILE 


The following procedures are used to manipulate the the TCL 
work file. They allow the user to add and delete records 
from the work file, display records, and save on disk the 
content of the work file. 
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MODIFYING A TCL WORK FILE RECORD 


ea — wannemenern 8 REEEeESRS 0 SEES EEyEGETmEEReSOD 


Modifying a record in the TCL work file involves’ two 
commands, LIST and SEQUENCE. Figure 4-13 illustrates the 
two-step process of modifying a TCL work file record. 


Screen 1 shows the user's request to display the TCL work 
file record that has sequence number OQOO0O06000 (that is, the 
LIST command). Screen 2 shows the requested record returned 
by Format Generator. 


Note that sequence numbers are eight characters long and 
occupy character positions 73 through 80 of the work file 


record. The sequence number is displayed at the beginning 
of the line. 


The user can now make the necessary changes to the line and 
send it back to the Format Generator using the SEQUENCE 
command, shown in screen 3. Finally, screen 4 indicates the 
Format Generator's response. The line is modified and 
available for processing. 


LIST 6000 


0006000 FORMAT F1 (A524, 


O006000 FORMAT F1 (AS,X2]4, % CHANGE 14 TO AA 


0006000 FORMAT F1 (AS5,X2]4, % CHANGE 14 TO Aa 
¥ 


f 
eee | 


Figure 4-13. Modifying a TCL Work File Record 


MERGING TCL WORK FILE RECORDS 


There are two commands available for merging records to the 
TCL work file: MERGE and RMERGE. They differ only in the 
handling of duplicate records (refer to explanations of the 
MERGE and RMERGE commands). The basic function of these 
commands is to add existing TCL format and function records 
into the TCL work file. Figure 4-14 illustrates the merging 
of records into the work file. USERI/TCL.SPECS is a disk 
file containing the entire TCL specifications for USERI1's 
MCS. 


In this example, only the function and format statements are 
merged in the work file. Merged records retain their 
sequence numbers. These added functions and formats can be 
compiled at the user's convenience. 


Figure 4-14. Merging TCL Work File Records 


SAVING THE TCL WORK FILE 


eRe Stine EERE 0 GERENETEERETEST Eee = Game SiEpentayeOCE ee 


Though normally the TCL work file is purged at the end of 
the session, the contents of the TCL work file can be saved 
on disk. The saved file contains all the current functions 
and formats created or altered in the work file. The 
contents of the saved file can be merged into the main TCL 
specifications file. Figure 4-15 illustrates the use of the 
SAVE command. Upon receipt of the Format Generator's 


response, the disk file USER1/TCL.NEW is locked in the disk 
directory. 


Figure 4-15. Saving the TCL Work File 


SECTION 5 


FORMAT GENERATOR COMMANDS 


This section provides a detailed description of the complete 
set of Format Generator commands. "Railroad" syntax 
diagrams are used to describe the syntax of these commands. 
An explanation of syntax conventions can be found in the 
GEMCOS Reference Manual. Commands are treated in 
alphabetical order. 


The following is a list of all the Format Generator 
commands. 


BYE 
COMPILE 
DEBUG 
DEFINE 
DELETE 
DISPLAY 
FORMAT 
FORMAT LAYOUT 
GET 

HELP 
IGNORE 
LINE 

LIST 
MERGE 
NULL INPUT 
RESEQ 
RMERGE 
SAVE 
SEQUENCE 
STATUS 
‘TEACH 
TERMINAL 
TEST 
TRANSLATE 
UPDATE 
WHAT 
WRITE 


BYE 


Semantics: 


The BYE command terminates the user's current formatting 
session and purges the user's TCL work file, the Format 
Layout file, and the Test Format file. When the command is 


entered by the last active user, the Format Generator goes 
to end-of-job (EOJ). 


Example: 


BYE 


COMPILE 


Syntax: 
| [SSS SSS SS Wo ee en ge ee | 
| | 
-- COMPILE ------------------------------------------------ 
- | | 
|-<UPDATE command>----- | 
| | 
l-<format or function>-| 
Semantics: 


The COMPILE command causes the Format Generator to compile 
all or part of the user's TCL work file. This command 
allows syntax checking of functions and formats. Those 
functions and formats that compile successfully are placed 
in the user's object Test Format file. They may be tested 
using the TEST command. If AUTOCOMPILE is set to true in 
the FORMAT command, the COMPILE command is automatically 
executed upon receiving a format layout. 


When the UPDATE command is used, an UPDATE is automatically 
performed on those formats that compile successfully. Refer 
to the discussion of the UPDATE command for a detailed 
description of the UPDATE feature. If a compile is 
automatically performed because AUTOCOMPILE is set to TRUE 
and the Format Generator is not executed in UPDATE mode 
(UPDATE is the default), no update is performed. 


Tf no format or function name is specified, all functions 
and formats in the Transaction Control Language (TCL) work 


file are compiled. Otherwise, only those functions and 
formats specified are compiled. If a specified function or 
format is not in the TCL work file, an error results, and 


that function or format is not compiled. 
Examples: 


COMPILE 

C FMT1L, FMT2 

C UPDATE 

C UP TO TEMP/FMTFILE FMT2, FMT4 


DEBUG 


Semantics: 


The DEBUG command is used as a toggle which alternately sets 
and resets debugging logic built into the Format Generator. 
It is not used for creating or testing formats but for 


evaluating the performance of the Format Generator code 
itself. 


When the debugging logic is invoked, the following 
information is written to a printer file: 


; A monitor of all procedures entered, including 
pertinent data for that procedure. 


‘ A program dump. This occurs whenever the Format 
Generator encounters a serious or fatal error. 


Example: 


DEBUG 


DEFINE 
Syntax: 


-- DEFINE --<define name>-----------~----------------------- | 
--- | | 
| 


<define specifications > 


-<integer>-| |-<string>------ | 


|-<hex string>--| 


Semantics: 


The DEFINE command can be used to represent the characters 
required to put a terminal into FORMS mode. Rather’ than 
refer to control strings by their hexadecimal values, the 
user may find it more convenient to introduce a special 
Shorthand for frequently used strings. 


For example, the control string 4"27E6" enables certain 
terminals to go into FORMS-= wmode. However, this control 
string may vary from terminal to terminal and is difficult 
to remember. The define DEFINE FORMSMODE = 4"27E6" can be 
used to represent the characters reguired to put a terminal 
into FORMS mode. The user enters only FORMSMODE to invoke 
this terminal function. 


TCL location specifications can also be used in a define, 
either alone or mixed with control strings. Define 
specification integer values must be less than 65536. A 
define name can be a maximum of 17 characters in length. 


Using an integer within the define specifications clause 
allows for multiple occurrences of a define name or any 
string. The allowable values are between one-and 255, with 
one being the default value. Defines can be nested toa 
maximum of nine levels deep. 


When a user enters the DEFINE command, the define named is 
added to the current Defines file for the terminal. The 
default Defines file is named GEMCOS/DEFINES and is shared 
by all users. Initially, this list contains predeclared 
defines. As new defines are added to the file, either 
replacing or supplementing existing ones, they become 
available to all users. If a user wants to use a Defines 
file other than the default Defines file, the current file 
can be changed using the define specifications option of the 
TERMINAL command (refer to the discussion of the TERMINAL 
command). 


The user specifies the place on a format layout where he/she 
wants a define used. This is done with the LINE command. 
Refer to the discussion of the LINE command for a more 
detailed description of define usage. 


The default Defines file contains certain predeclared 
defines. The following list gives the names, hexadecimal 
values, and meanings of the predeclared defines: 


Define Name Hex Value Meaning 
CAN 4°18" Start blinking (hex value 
requires one character 


position). 


CR 4° 0D" Carriage return. 

DCl 4"11" Stay in receive. 

DC4 4"°3Cc" Cursor home. 

EM | 4"19" Protected data (hex value 
requires one character 
position). 


ESC 4" 27" Escape. 
FF 4"oc" Form feed. 


HT 4"05" Horizontal tab (hex value 
requires variable number of 
character positions). 


LF 4"25" Line feed. 
NULL 4" 00" Null. 
SI 4"OF" Start underline (hex value 


one character position). 


SO 4"0E" Start negative video (hex 
value requires one 
character position). 


SUB 4"3r" Start bright video (hex 
value requires one 
Character position). 


CLEAR FF Clear screen (hex value 
requires one character 
position), home cursor. 


FORMSMODE ESC "W" Enable FORMS mode. 


When DEFINE <define name> appears alone, the define name and 
its current value are displayed. If the specified define 
does not exist, an error message results. Hex value 
requires a variable number of character positions. 


Examples: 


DEFINE CLEAR = FF 

DEFINE NEGBLINK = SO CAN 
DEFINE LINE80 80 "-" 
DEFINE SMALLA 4"81" 


DEFINE SKIP4 = @ + 4 
DEFINE FORMSMODE 


DELETE 


Syntax: 


-- DELETE ------------------------------------------------- 
--- | | 


|-<sequence range>-| 


<sequence range> 


Semantics: 


The DELETE command allows deletion of single lines, ranges, 
or of the entire TCL work file. It affects only the TCL 
work file. 


Examples: 


DEL 100 - 500 

DEL 2000 - END 

DEL 300 

DELETE %(deletes entire TCL work file) 


DISPLAY 


Syntax: 


~- DISPLAY ----- enn enn nn rr rr renner nee 


Semantics: 


The DISPLAY command is used to display the contents of the 
Format Layout file. Only the text and data portions of each 
line are displayed. Location and control information can be 
viewed or entered using the LINE command. 


The DISPLAY command is often used in the following 


situation. A format is received as a result of entering the 
FORMAT command followed by a format layout. However, the 
user wants to change the layout. The user re-enters the 


FORMAT command, placing the terminal in an Expecting Format 
Layout mode. Instead of laying out an original format, the 
Operator enters DISPLAY to obtain the current layout for 
correction. The terminal is still in Expecting Format 
Layout mode, and the operator can now correct the layout and 
return it to the Format Generator. 


If the DISPLAY command is used in this manner, all location 
and control information previously associated with the 
format is discarded when the format is re-sent. If this 
command is entered while the terminal is in an Expecting 
Format Layout mode, the word DISPLAY must be entered 
starting at the first position on the terminal. It must be 
the only word entered. 


Example: 


DISPLAY 


FORMAT 


Syntax: 
-- FORMAT --<format name> ------- ee nn rr nr rrr > 
| < =e a  n enn nnn | 
| | 
a FE Fr ROS ea a PO GO ry sey Pe Per ae Pe EN PT RIN es Ee IT ed ER ER Ee ay 
| | 
|-/1\- CLEAR ----------- TRUE --| 
| | | - | 
|-/1\- FORMSMODE ---| |- FALSE -| 


|-/1\- RESIDENT aan! 
|-/1\- AUTOCOMPILE -| 


Semantics: 


The FORMAT command is used to identify and establish certain 
attributes for a format to be created. (See "Format Layout" 
in this section.) Unless there is an attribute error found 
in the input, the FORMAT command always leaves the terminal 
in an Expecting Format Layout mode. This means that a 
format has been named and the Format Generator is now 
expecting a layout of the format from the next transmission. 
Once in Expecting Format Layout mode, the user must then do 
one of three things: 


: Clear the screen, lay out a format on the screen 
and transmit the format layout to the Format 
Generator. 


; Enter IGNORE, which removes the terminal from 
Expecting Format Layout mode. Then enter another 
command, Or start over with a new format name and 
attributes. 


; Enter DISPLAY, which displays a previously created 
format layout for correction and leaves’ the 
terminal in an Expecting Format Layout mode. 


To determine if the terminal is in an Expecting Format 
Layout mode, a STATUS or WHAT command can be entered without 
changing the current format or terminal status. 


Format attributes are assigned logical values of TRUE or 
FALSE. A format name can be a maximum of 17 characters in 
length. 


The format attributes have the following meanings: 
ATTRIBUTE DESCRIPTION 


CLEAR Inserts the contents of the CLEAR define at 
the beginning of the format. The default 
value of the CLEAR define is 4"0C". The 
default value of the CLEAR attribute is 
FALSE. 


FORMSMODE Inserts the contents of the FORMSMODE define 
at the end of the format. The default value 
of the FORMSMODE define is 4"27EF6". The 
default value of the FORMSMODE attribute is 
FALSE. Any allowable characters are 
acceptable as forms characters. The symbols 
US, GS, and FS may be used to start a data 
field, and the RS symbol may be used to enda 
data field. 


RESIDENT Causes the format to be compiled as a format 
format. Since resident formats are kept in 
memory rather than disk, their response time 
is generally faster than that of nonresident 
formats. To make a resident format available 
to the "live" GEMCOS environment, the MCS has 
to be restarted after the format is updated. 
(Refer to the discussion of the UPDATE 
command.) The default value for the RESIDENT 
attribute is FALSE. 


AUTOCOMPILE Causes the TRANSLATE and COMPILE commands to 
be executed automatically by the Format 
Generator as soon as the format layout is 
received. If the translated format is a new 
format, it is added to the end of the TCL 
work file; if not, the translated format 
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replaces the old copy. The compiled format 
is added to to the user's object Test Format 


file. The default value for the AUTOCOMPILE 
attribute is FALSE. 


Examples: 


FORMAT FMT] 
FORMAT FMT2 CLEAR=T FORMSMODE=T RESIDENT=T AUTOCOMPILE=T 


FORMAT LAYOUT 


The format layout is not a command, but simply the screen 
layout of a format transmitted to the TCL Workfile when the 
terminal is in Expecting Format Layout mode. 


Refer to "Creating a Format" in Section 4 for instructions 
on how to lay out a format. 


GET 


Syntax: 


se GET S==<KTOrmlat Name? SS S34] 4S 5 SS5 5355555545 5-- 55-245 > 
ee = 
|- FROM <file name> -| 


<file name> 


—-=<multi-file [D> <-<<---<<<<6<<3--3<s—3 6533 4-<53<5-56-555-5> 


|- / <file ID> -| |- ON <pack ID> -| 


Semantics: 


The GET command is used to retrieve a format from an object 
format file and to convert the format into a format layout. 
The converted format is stored in the Format Layout work 
file. If there is no file name specified, the Format 
Generator attempts to retrieve the format from the user's 
current object Test Format file. 


The following attributes cannot be retrieved from an object 
format: 


; Update variables in a variable repeat expression. 
; If there is a file name specified, TCL functions 


are not converted. 


Successful conversion of the specified format results ina 


format layout as though the user had used the FORMAT and 
LINE commands to layout and modify the format from scratch. 


Examples: 


GET FORMATX]1 
G FORMATX2 FROM FORMAT/LIBRARY 


Syntax: 


~=-— HELP --------------+---- wo----------------------------- | 
| - | | | | 
|- TEACH -| |-<any valid format generator command>-| 


The HELP command is used to obtain a list of valid Format 
Generator commands or to learn the syntax of a particular 
command. Refer to the discussion of the TEACH command for 
more detail. 


Example: 


HELP 


Ge a 


IGNORE 


Syntax: 


-- IGNORE --------------------------------- -~--------------- 


Semantics: 


The IGNORE command terminates the Expecting Format Layout 
mode. This command must be entered starting at the first 
position on the terminal, and IGNORE must be the only word 
entered. 


Example: 


IGNORE 


LINE 


Syntax: 


—-= LINE ——<integer > 9-3-3 3 eee ee eee > 


|-<litrl line>--<data line>--<loc line>--<ctrl line>-| 


Semantics: 
The LINE command performs two primary functions: 


‘ It allows for the insertion of the pound sign (#) 
and the ampersand (&) as text characters within 
literal expressions on a layout. These characters 
cannot be used as text characters ina format 


layout due to their special usage in defining 
fields. 


; It allows for the insertion of terminal control 


strings into the format layout. This type of 
insertion is useful when the format layout 
requires characters not available on the user's 
keyboard. 


When the LINE command consists only of the word LINE 
followed by a line number, the current layout of the line is 
displayed for modification. 


An explanation of the four different types of lines and 
their associated meanings follows: 


Line Type Explanation 
<literal line> Contains the titles and headings which 
are a part of the message format. These 


literals become part of the message. An 


An example of the first usage of the 
LINE command is demonstrated in the 


oe 2. 


following example. The user wants the 
format to read ID #:, but has to enter 
ID #: because the pound sign (#) is a 
special control character. However, the 
pound sign (#) can be inserted in the 
proper place on the literal line. 


<data line> Each character on the data line 
represents a data character in the 
program message. The special characters 
(pound sign (#) and ampersand (&)) 
originally were inserted using the 
FORMAT command. These special 
Characters can be added or deleted on 
this line wherever necessary. 


<location line> Used to specify the position within the 
line where a control string is to be 
inserted. A left angle bracket (<) 
indicates that a control string clause 
is to be inserted preceding this 
character position. A right angle 
bracket (>) indicates that a control 
string clause is to be inserted 
following this character position. For 
each left or right angle bracket in the 
location line, there must be a 
corresponding control string clause on 
the control line. 


<control line> Consists of define names, control 
strings, and location specifiers 
(control specs) starting with an at 
Sign (@). Refer to "Location Specifiers 
(Remapping)" in Section 3 for an 
explanation of location specifiers. A 
control string clause can consist of any 
number of control specs. However, 
control specs clauses must be separated 
by commas. 


An example of a displayed response to entering LINE 1 is 
shown Figure 5-1. 


LINE 01 
STUDENT NAME [ ] ID 


FFFFFLEL FF 


Figure 5-1. Response to Entering LiNE 1 


Example: 
In Figure 5-l, the user wants to make the following 
changes: 
dg Add a pound sign (#) after the word ID. This is 


done by inserting the pound sign (#) at the 
appropriate place on the <literal line>. 


Modify the CLEAR function to clear, followed by a 
horizontal tab. This is done by changing CLEAR to 
CLEAR, HT on the <control line>. 


Adjust the internal location pointer in the data 
message prior to extracting the student name from 
the message. This is done by inserting a right 
angle bracket (>) on the location line underneath 
the first left square bracket (LL), and inserting 


A RS 


the sequence "; @ +8" at the end of the <control 
line>. 


After this modification is completed, Figure 5-1 appears as 
Figure 5-2 prior to transmission: 


LINE 01 
STUDENT NAME [ ] ID # [ ] 


FEFFFEEFEF SLbbbeo 


< 
CLEAR, HT; @ +8 


Figure 5-2. Modified Response to Entering LINE 1 


LIST 


Semantics: 


Diverse information can be displayed using the LIST command. 
If LIST is entered alone or with a sequence range, all or 
portions of the TCL work file are displayed. If L( IST) 
DEFINES is entered, a list of the names of all defines in 
the user's current Defines file is displayed. If L(IST) 
FORMATS is entered, a list of the names of all formats in 
the user's Test Format file is displayed. If the list 
involves more than one full screen of dats, subsequent 
screens can be displayed by transmitting a blank or series 
of blanks. The list can also be terminated by the entry of 
any other command. 


Examples: 


LIST 

L 100 - 600 
LIST DEFINES 
L FORMATS 


MERGE 
Syntax: 


-- MERGE --<file name>--<sequence range>—------------------- 


<file name> 
—~-<multi-file [D> ----- enn nen er rer rrr rrr rrr cen 


|- / <file ID> -| |- ON <pack ID> -| 


<sequence range? 


Semantics: 


The MERGE command merges all or part of the specified file 
with the TCL work file by collating the sequence numbers. 
The merged records become part of the TCL work file. When 
records in the merged file andthe TCL work file have 
identical sequence numbers, the TCL work file records are 
retained, and the merged file records are ignored. 


Examples: 


MERGE PERMANENT/TCL 
MER TEMP/TCL.BR 1200-2500 


NULL INPUT 


Null input is not a command. It consists of a series of one 
Or more blanks transmitted from home position. A null input 


is used only to receive the next screen of requested 
information after a LIST command is entered. 


Example: 


<one space> 


RESEQ 


Syntax: 


-- RESEQ --<sequence range>-------------------------------- | 


|-<base>-| |- + <increment> -| 


<sequence range> 


Semantics: 


The RESEQ command is used to resequence all or part of the 
TCL work file. This command affects only the TCL work file. 


If the no sequence range is specified, the entire TCL work 
file is resequenced. If no base is specified, the default 
value of 100 is used. If no increment is specified, the 
default value of 100 is used. If a sequence range is 


specified, then the resequenced range must not exceed the 
original range specified. This command should be used with 
caution, since the entire TCL work file is rewritten every 
time this command is used. 


Examples: 


RESEQ 

RES 100-1000 

RESEQ 100 % (reseq entire file, base = 100) 
RES 1000 + 1000 

RES + 500 

RESEQ 100-2000 100 + 10 


RMERGE 
Syntax: 


-- RMERGE --<file name>--<sequence range> SSS ee ee 


<file name> 


—--<multi-file ID>----------------~-~-------~------------------ 


|- / <file ID> -| |- ON <pack ID> -| 


<sequence range? 


(CAEN) Gre RARE are GRCURD GENE WARE DUD GURUS GN WR ED ET GED ORES SE QED OREN) GOS SEU OE mE GUND SA SU RE GOR ORD GED CORED GED GERD OED SEER GR ETUDE BREE GERD NNT GED FEU Guede SEND OND RTD WORE Gee Ge ae nes ante mem (OE en ERS RO NEED 


Semantics: 


The RMERGE command merges all or part of the specified file 
name with the TCL work file by collating the sequence 
numbers. The merged records become part of the TCL work 
file. When records in the merged file and the TCL work file 
have identical sequence numbers, the mreged file records are 
retained, and the TCL work file records are ignored. 


Examples: 


RMERGE TEMPORARY/TCL 
RM PERM/TCL.11.08 100-2000 


SAVE 
Syntax: 


oe (SAV => IAG: ==5 fi 1S -Nanler Ha a> Hee Se S= ae Se ee Se See eS 


<file name> 
——<multi-file [D> ------ 9-93 rrr rr rrr rrr 


|- / <file ID> -| |- ON <pack Id> -| 
Semantics: 


The SAVE command is used to save the contents of the TCL 
work file on disk. If the specified file name is already on 
disk, the TCL work file is not saved, and an error message 
is issued. The saved file can be merged with the primary 
TCL specifications file to incorporate new formats into the 
MCS ona permanent basis the next time the TCL compiler is 
run. 


Examples: 


SAVE AS USER1 /NEWFORMATS 
SA AS FORMPACK/TCLFORMATS/NOV .08.79 


SEQUENCE 


Syntax: 


---<integer>----<TCL source image>------------------------- 


Semantics: 


The SEQUENCE command allows insertion of source images 
directly into the user's TCL work file. The user enters a 
sequence number, starting at the first position on the 
terminal, followed by any valid TCL format or function 
declaration. The first eight positions on the terminal 
screen are reserved for the sequence number. 


However, leading zeros may be suppressed, since the Format 
Generator terminates a sequence number upon receipt of the 
first non-integer character or after eight continuous 
integer characters. To enter an integer character 
immediately after the sequence number, the sequence number 
must occupy all eight sequence number positions. When a 
source image with the same sequence number already exists in 
the TCL work file, the work file image is replaced by the 
new input. 


This command can be entered at any time during the session, 
except when a terminal is in an Expecting Format Layout 
mode. It can be used to modify a format that was retrieved 
using the GET command, to modify a format generated from 
translation of a format layout, or to create a format using 
the TCL syntax. 


Examples: 


OOOOOLOOFORMAT Fl ("THIS IS A FORMAT",A6,12,4(A8,X3)). 
5OOFORMAT F2 ("ANOTHER FORMAT",1I5,3(A2),X3, "FINI"). 
1000 , THIS IS THE MIDDLE OF A FORMAT",A6,13,X2. 
OO300FUNCTION BOOLEAN (1: "YES", O: "NO"). 


STATUS 


Syntax: 


see CTATUG 236 eeoSea Sees eee eee eee ee eee eae 
| --- | 
|- WHAT ---| 


Semantics: 


The STATUS command is used to obtain information about a 
particular station that is attached to Format Generator. 
The information obtained using the STATUS command includes: 


»- Station RSN. 

- Current terminal attributes. 

- Current TCL work file size. 

- Debug option status (set or reset). 

- Name of format currently in the Format Layout file. 


If a STATUS command is entered while the terminal is in an 
Expecting Format Layout mode, the status report includes the 
name of the new format to be entered into the Format Layout 
file and displays the message Expecting Format Layout, 
indicating that a format layout is expected. While in this 
mode, the STATUS command must be entered starting at the 
first position on the terminal, and STATUS must be the only 
word entered. The STATUS and WHAT commands are synonymous. 


Example: 


STATUS 


TEACH 


Syntax: 


|--<Format Generator command>---| 


Semantics: 


The TEACH command is used to obtain a list of valid Format 
Generator commands or to learn the syntax of a particular 
command. TEACH entered alone displays a one-screen listing 
of all valid Format Generator commands and their 
abbreviations. Also included is -the syntax of <file name> 
and <sequence range>, which are syntax elements used ina 
number of commands. The word TEACH accompanied by any 
Format Generator command displays the syntax for that 
particular command with a short explanation of its purpose. 


Examples: 


TEACH 
TEACH COMPILE 


TERMINAL 


Syntax: 


|--- LINES <integer> --------------------------- | 
| | 
|--- WIDTH = <integer> --------------------------- | 
| | 
|--- DEFINES = <file name> ----------------------- | 


|- MERGE -<file name>-| 


Semantics: 


The TERMINAL command allows the user to set certain 
attributes that may vary from terminal to terminal. The 
lines and width attributes affect the size of messages 
generated by the Format Generator, as well as how format 


layouts are broken up. If incorrect lines and/or width 
attributes are entered, output to the terminal becomes 
garbled. 


The Defines attribute specifies the name of the current 
Defines file for the user as described under the DEFINE 


command. If the Defines file does not exist in the disk 
directory, a new file (empty) is created for the user. This 
file becomes the current Defines file. If a Merge file name 


is specified and exists, the defines from this file are 
merged into the Defines file. T£ the same define(s) exist 
in both files, the Merge file defines are used. Any 
previous Defines file is saved on disk. 


TERM entered alone displays the current attributes. TERM 
entered with an attribute is used to set the attributes and 
to display the new terminal attributes. The default values 
are: 

Line = 24 

Width = 80 

Defines = GEMCOS/DEFINES. 
Examples: 


TERMINAL LINES=12 WIDTH=40 


TERM DEFINES = FORMGEN/DEFINES MERGE USER1/DEFINES 
TERMINAL 


LOS 


TEST 


Syntax: 


---- TESTIN ----<format name> -—-------------------- 
| | | | 
|- TESTOUT -| |-<string>----- | 
| | 


l-<hex string>-| 
Semantics: 


The TEST command allows the user to apply a format to a test 
message and to return the resulting formatted message to the 
terminal. The format must be a successfully compiled format 
created during the current formatting session. It may be a 
format created directly in the TCL work file or indirectly 
using a format layout. 


If no test message is sent, the format is applied to a blank 
message. Characters that do not exist oon the terminal's 
keyboard may be entered in the form of hex strings. 


Some GEMCOS format editing phrases operate differently 
depending on whether the format is executed as an input 
format or an output format. TESTIN and TESTOUT execute a 
format as an input or output format respectively. 


Examples: 


TESTIN Fl "ABCD" "XYZ" 4"8182" "1234" 
TESTOUT F2 " X¥ " 4"85" " y " 
TESTOUT F3 


TRANSLATE 


Syntax: 


Semantics: 


The TRANSLATE command is used to translate the format layout 
into TCL source images and to put these images into the TCL 
work file. The translated format is placed at the end of 
the TCL work file. If the format already exists in the work 
file, the old TCL source images are removed. 


If control information has been specified for a line of the 
format, andthe line contains define names, these defines 
are expanded into their component parts, anda comma is 
inserted between parts before translation is performed. If 
error 69 or 97 occurs, a line number is supplied as part of 
the error message. (See Appendix B for text of error 
messages.) The LINE command can then be used to determine 
the nature of the error. 


When AUTOCOMPILE is set to TRUE, the TRANSLATE command is 
automatically executed upon receipt of a format layout. 


Example: 


TRANSLATE 


UPDATE 


Syntax: 


~- UPDATE ------------------------------------------------- 
~- | | | | 


l- TO <file name> -| |-<format name>-| 


<file name> 


--<multi-file ID>------------------------------------------ 


|- / <file ID> -| I- ON <pack ID> -| 


Semantics: 


The UPDATE command is used to place an updated version of 
existing formats into an object Format file. An error 
results if the specified formats do not already exist in the 
object Format file or if the format file does not exist. 
This command is NOT valid if the Format Generator is NOT 


executed in UPDATE mode. UPDATE mode is the system default 
(SW O = OQ). 


If no file name is specified, the current live GEMCOS format 
file, named GEMCOS/MCSFORMATS, is assumed. Otherwise, the 


specified file is updated. If no file name or format name 
is specified, all formats in the user's object Test Format 
file are eligible for update. Otherwise, only the specified 


formats are updated. 


This command does not actually cause the updated version of 
a format to be made available to stations in a live GEMCOS 
environment. Rather, it places an updated copy of the 
format in the specified Format file. For these updated 
formats to be made available to stations in the live GEMCOS 
environment, a *UPD network control command (NCC) must be 
performed through a GEMCOS control station or the ODT 
(On-line Data Terminal). 


Examples: 


UPDATE 
UP TO TEST/FORMATFILE 
UP TO USER1/FORMFILE FMT1, FMT2, FMT3 


WHAT 


Semantics: 


The WHAT command is used to obtain information about a 
particular station that is attached to Format Generator. 
Refer to the STATUS command for more detailed discussion. 
The STATUS and WHAT commands are synonymous. 


Example: 


WHAT 


WRITE 


|- FORMATS -| 


Semantics: 


The WRITE command, when entered alone, writes the contents 


of the TCL work file to the line printer. When the FORMAT 
option is used, the contents of the format layout work file 
is written to the line printer. Only the text and data 


portions of each line are printed. 


Examples: 


WRITE 
WR FORMAT 


APPENDIX A 


FORMAT MAKER INFORMATION 


The following three tables contain further B 1000 GEMCOS 
Format Maker information. 


FORMAT MAKER FILES 


The B 1000 GEMCOS Format Maker files are summarized in the 
following table. 


Name Device Explanation 
Internal: Remote A remote file opened by the 
MCSREMOTE Format Maker for I/O between 
the Format Maker and the 
External: user. Default number of 
MCSREMOTE stations is 10. Can be file 
equated. 
Internal: Disk The Test Format file in 
MCSTESTFOR which t is the <time stamp>. 
If empty, purged at end of 
External: session. If contains 
MCSNONFORM/t formats, saved at end of 
session. 
Internal: Disk File created by the GET 
MCSGETFILE command. Closed at 


completion of GET. 
External: 


none 
Internal: Disk File created by the OPEN 
MCSOPNFILE command. Input only. 
Closed at completion of 
External: OPEN. 
none 
Internal: Disk The Library file in which 
MCSLIBRARY the t is the <time stamp> 
and which is used to store 
External: COBOL entries for each 
MCSLIBRARY/t indicated format field. 


Internal: Printer 
MCSPRINT 


External: 
MCSPRINT 


Tnternal: Printer 
MCSMONITOR 


External: 
MCSMONITOR 


A Printer file used in 
WRITE. Default device 
setting is printer or 
printer backup. Output 
only. 


A Printer file used by 
DEBUG. Default device 
setting is printer or 

printer backup. 


SYSTEM LIMITS 


General 


Format names: 

Maximum users: 

UPDATE mode: 

Maximum fields in format: 
Maximum number of formats: 
Maximum size of Library file: 
Terminal size: 


UPDATE Command 
Number of characters of input: 
Number of named formats: 


Maximum number of formats: 
UPDATE file default name: 


Program Switches 
SWO 


SW1L 


AND DEFAULTS 


Limit/Default 
1 to 6 characters 
1 
TRUE 
144 
804 


20000 records 
1920 bytes (TD compatible) 


Up to 1000 

1 to 166 

400 before *UPD FORMATS 
GEMCOS /NONINTERS 


If equal to 0, UPDATE 
cannot be used. 

If equal to 1, DEBUG 
trace will be turned on 
at beginning-of-job. 


ERROR 
ERROR 
ERROR 
ERROR 


ERROR 


ERROR 


ERROR 
ERROR 
ERROR 
ERROR 
ERROR 
ERROR 
ERROR 
ERROR 
ERROR 
ERROR 


ERROR 


ERROR 


OO 


Ol 


O02: 


O03: 


04: 


05 


O06: 


O7: 


O08: 


09: 


10: 


ll: 


12: 


Ls 


14: 


15: 


16 


17: 


FORMAT MAKER ERROR MESSAGES 


UNRECOGNIZED COMMAND 

ACCESS DENIED, MAX USERS EXCEEDED 
UNEXPECTED TOKEN 

<not used> 

MISSING FILE NAME 


The command did not contain a necessary file 
name. Reenter the command with the file name. 


INVALID FILE NAME 


The file name is not a valid file title. 
command with a valid file name. 


Reenter 


FILE MISSING - <file name> 


NOT ALLOWED TO USER CURRENT TESTFILE WITH COMMAND 
INCORRECT RELEASE LEVEL IN TESTFILE - <file name> 
FILE IS EMPTY - <file name> 

MAXIMUM NUMBER OF OUTPUT FIELDS EXCEEDED 
MAXIMUM SIZE OF COMPACTED RECORD EXCEEDED 
FORMAT NOT FOUND 

FILE ALREADY ON DISK —- <file name> 
NO MORE ROOM IN LIVE FORMAT FILE 
NO CURRENT FORMAT 

MISSING FORMAT NAME 


The command did not contain a necessary format 
name. Reenter command with a valid format name. 


INVALID FORMAT NAME 


The format name entered is longer than six 
characters or contains an illegal character. 
Reenter the command with a valid format name. 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


18 


19: 


20: 


Diss 


22% 


23: 


24 


25:3 


20: 


27: 


28: 


20 


eo 


30: 


31: 


32% 


35% 
34:3 


35 


30: 


INVALID ATTRIBUTE SPECIFICATION 

ATTRIBUTE ALREADY SPECIFIED 

'=' EXPECTED 

MISSING 'FROM <FILE NAME> ' 

MISSING ATTRIBUTE VALUE 

MISSING FIRST QUOTE 

MISSING TEST DATA 

MISSING FINAL QUOTE 

TOO MUCH TEST DATA 

NOT ENOUGH TEST DATA 

MISING DIRECTORY RECORD IN FILE 

NOT A VALID GEMCOS FORMAT FILE - <file name> 

', ' EXPECTED 

MAXIMUM NUMBER OF FORMATS EXCEEDED 

The user has attempted to enter more than 804 
formats in the format file. Delete unneeded 
formats before adding more or create a new format 
file. 

DUPLICATE FORMAT NAME 

The user has attempted to create a format with an 
existing format name. Create format with unique, 
valid format name. 

FORMAT MAKER NOT RUN IN UPDATE MODE 

FORMAT WAS DELETED 

**FORMAT NAME MISMATCH IN TESTFILE** 


COMMAND MAY NOT BE USED AT THIS TIME 


The IGNORE command has been transmitted when the 
terminal was not in Expecting Format Layout mode. 


ERROR 37: 


ERROR 38: 


ERROR 39: 


UPDATE TABLE IN LIVE FORMAT FILE FULL 
EOF/EXCEPTION ERROR 


FORMAT NOT FOUND - NO FORMATS UPDATED 


Pi 


APPENDIX B 


FORMAT GENERATOR INFORMATION 


The following three tables contain further B 1000 Format 
Generator information. 


FORMAT GENERATOR FILES 


The B41000 Format Generator files are summarized in the 
following table. 


Name Device Explanation 
Internal: Remote A remote file opened by the 
MCSREMOTE Format Generator for I/O 
| between the Format Generator 
External: and the user. Maximum 
MCSREMOTE number of stations per copy 
is 1. Can be file equated. 
Internal: Disk A TCL workfile where n is an 
MCSTCLWRKn integer from 0 to 9 
indicating the the user and 
External: t is the <time stamp>. 
MCSTCLWRKN/t Purged at the end of the 
formatting session. 
Internal: Disk The Format Layout file in 
MCSLAYOUTn which n is an integer from 0 
to 9, indicating the user, 
External: and t is the <time stamp>. 
MCSLAYOUTn/t t is the same for all users. 
Purged at end of session. 
Internal: Disk Used to read and write 
MCSLIVEFOR formats from any live GEMCOS 


format file. 
External: 


GEMCOS /MCSFORMATS 
Internal: Disk The Test Format file in 
MCSTESTFOR which n is an integer from 0 
| to 9 indicating the user and 
External: t is the <time stamp>. t is 
MCSTSTFORn/t the same for all users. 


Internal: Disk 
MCSDEFINE 


External: 
GEMCOS /DEFINES 


Internal: Disk 
MCSUTILITY 


External: 
none 


Internal: Disk 
MCSMERGE 


External: 
none 


Internal: Printer 


MCSPRINT 


External: 
MCSPRINT 


Internal: Printer 


MCSMONITOR 


External: 
MCSMONITOR 


Purged at the end of the 


session. 


The Defines file. System- 
supplied or created by user. 
User-created Defines files 
are saved at the end of a 
session. 


System Utility file used in 
RESEQ and other system 
functions. 


System Utility file used in 
MERGE and RMERGE. Not 
accessible by user. 


A Printer file used in 
WRITE. Default device 
setting is printer or 
printer backup. Output 
only. 


A Printer file used by 
DEBUG. Default device 
setting is printer or 
printer backup. 


SYSTEM LIMITS AND 


General 


Format name: 
Define name: 
Sequence number: 
Maximum users: 
UPDATE mode: 
Maximum file size: 


COMPILE Command 
Number of characters of input: 
Number of named formats: 
UPDATE file default name: 
DEFINE Command 
Number of occurrences of 
<define type>: 
Length of string or hex string, 
including quotes: 
<Define loc> <integer>: 
Default Defines file name: 
Define nesting: 


DELETE Command 


Default delete range: 


FORMAT Command 
Default <format attributes> 
value; 
GET Command 


Default format file name: 


LINE Command 


Number of characters input: 
Length of <control specs>: 


DEFAULTS 


Limit/Default 


1 to 17 characters 
1 to 17 characters 
O thru 99999999 

10 

TRUE 

65535 records 


Up to 1000 
1 to 58 
GEMCOS /MCSFORMATS 


1 to 255 
Up to 173 characters 
1 to 65535 


GEMCOS /DEFINES 
Up to 9 


Entire TCL workfile 


FALSE 


User's Test Format file 


Limit/Default 


Up to 1000 
Up to 173 characters 


LIST Command 


Default list range: 


MERGE Command 


Merge file record size: 
RESEQ Command 

Default resequence range: 
RMERGE Command 


RMERGE file record size: 


TERMINAL Command 


Number of lines: 


Number of characters per line: 


TEST Command 
Length of input data: 


Length of output data: 
Forms request: | 


TRANSLATE Command 


(In conjunction with LINE command) 
Length of <control string>: 
Length of <control specs>: 


UPDATE Command 


Number of characters of input: 


Number of named formats: 
UPDATE file default name: 


Entire TCL workfile 


80 or 90 characters 


Entire TCL workfile 
starting at 100 
With increment of 100 


80 or 90 characters 


1 to 24; default is 24 
1 to 80: default is 80 


Up to 600 characters 

Up to 2000 characters 

If <test message> is 
empty, no format clause 
can exceed 600 characters 


Up to 1520 characters 
Up to 68 characters 
without a comma 


Up to 1000 
1 to 58 
GEMCOS /MCSFORMATS 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


HRROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


OO: 


Ol: 


O2: 


03: 


O04: 


O05: 


O06 


O7: 


O08: 


O09: 


10 


ll: 


12: 


13: 


14: 


15: 


16: 


17: 


FORMAT GENERATOR ERROR MESSAGES 


UNRECOGNIZED COMMAND 

ACCESS DENIED, MAX USERS EXCEEDED 

UNEXPECTED TOKEN 

INTEGER EXPECTED 

MISSING FILE NAME 

The command did not contain a necessary file 
name. Re-enter the command with the file name. 
INVALID FILE NAME 


The file name is not ae valid file title. 


Re-enter the command with a vaid file name. 
FILE MISSING —- <file name> 
FILE LOCKED -— <file name> 


FILE IS NOT FORMAT GENERATOR COMPATIBLE - <file 


name> 
FILE IS EMPTY - <file name> 
TCL WORKFILE IS EMPTY 


BEGINNING SEQUENCE NUMBER EXCEEDS ENDING SEQUENCE 
NUMBER 


‘AS' EXPECTED 
FILE ALREADY ON DISK - <file name> 
SEQUENCE NUMBERS HAVE EXCEEDED MAXIMUM SIZE 


RESEQUENCED RECORDS HAVE OVERLAPPED EXISTING 
RECORDS | | 


MISSING FORMAT NAME 
The command did not contain 


name. Re-enter 
name. 


a necessary format 
the command with a valid format 


INVALID FORMAT NAME 


ERROR 
ERROR 
ERROR 


ERROR 


ERROR 
ERROR 
ERROR 
ERROR 
ERROR 
ERROR 
ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


18: 
19: 
20: 


21: 


223 
23% 
24: 
22% 
26: 
27: 
28: 


29: 


30: 


31:3 


32: 


33: 


34: 


The format name is longer than six characters 
contains an illegal character. Re-enter 
command with a valid format name. 


Or 
the 
INVALID ATTRIBUTE SPECIFICATION 
ATTRIBUTE ALREADY SPECIFIED 
'=' EXPECTED 
COMMAND MAY NOT BE USED AT THIS TIME 


The IGNORE command was transmitted when the 
terminal was not in Expecting Format Layout mode. 


LINE NUMBER EXPECTED ON FIRST LINE 

LINE NUMBER DOES NOT EXIST 

INVALID CHARACTER(S) ON DATA LINE 

INVALID CHARACTER(S) ON LOCATION LINE 
UNBALANCED LOCATION & CONTROL INFORMATION 
TEXT & DATA CHARACTER OVERLAP 


FORMAT LAYOUT FILE IS EMPTY 


FILE IS NOT A VALID GEMCOS FORMAT FILE - <file 
name> 

', ' EXPECTED 

MAXIMUM NUMBER OF FORMATS EXCEEDED 

The user has attempted to enter more than 804 
formats in the format file. Delete unneeded 


formats before adding more or create a new format 
File. 


DUPLICATE FORMAT NAME 

The user has attempted to create a format with an 
existing format name. Create format with a 
unique, valid format name. 


FORMAT GENERATOR NOT RUN IN UPDATE MODE 


EOF ON WORKFILE - NOT ALL FORMATS COMPILED 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


35: 


36: 


37: 


38: 


39: 


40: 


41: 


42: 


43: 


44: 


45: 


46: 


47: 


48: 


49 


50: 


51 


52 


53°: 


54: 


No more room remains in the work file to 
accommodate compiled formats. Delete unneeded 
formats before attempting to compile any more or 


create a new format file. 


.' OR ',' EXPECTED 
'(' EXPECTED 
')' EXPECTED 
COMMA, CLOSING QUOTE OR ')' EXPECTED 
']' EXPECTED 


RESIDENT EXPECTED 
';' OR ',' EXPECTED 
'FOR' EXPECTED 

MISSING MAX REPETITIONS IN REPEAT PART 
The user 


has attempted to merge a hand-written 


TCL specification into a Format Generator TCL 
file. The specification lacks a number 
indicating the number of times an operation is to 
be repeated. Supply a number from 1 to 255. 

‘OR' EXPECTED 

MISSING INTERNAL SIZE 

MISSING FIELD WIDTH 


INVALID OR MISSING VARIABLE DECLARATION FIELD 
LENGTH 


INVALID OR MISSING VARIABLE IDENTIFIER 

MORE THAN 32 LEVELS OF PARENTHESES 

INVALID REPEAT PART VALUE OR INVALID ITEM PHRASE 
INVALID MAX REPETITIONS IN REPEAT PART 
UNDECLARED VARIABLE IDENTIFIER 

INVALID INTERNAL SIZE 


INVALID OR MISSING FIELD DELIMITER 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


BRROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


68 


INVALID FIELD WIDTH SIZE 

INVALID OR MISSING SKIP DELIMITER 

MISPLACED REPEAT PART 

INVALID LOCATION SPECIFIER VALUE 

INVALID OR MISSING LOCATION SPECIFIER VALUE 
UNDECLARED FUNCTION IDENTIFIER 

MISSING FUNCTION IDENTIFIER 

INVALID OR MISSING ITEM TYPE 

INVALID OR MISSING INTERNAL SIZE 

TRANSLATE STRING CANNOT EXCEED 6 CHARACTERS 
INCOMPLETE FORMAT STATEMENT 

DUPLICATE VARIABLE DECLARATION 

UPDATE TERMINATED - NOT ALL NAMED FORMATS FOUND 
The user has attempted to update a nonexisting 
format name. Check list of UPDATE messages for 
the last entry. Re-enter UPDATE command with the 
correct format name. 

FORMAT NOT FOUND IN FORMAT FILE 


A nonexisting format name was entered. Enter the 


-correct format name. 


<control specs? TOO LARGE FOR TCL WORKFILE 
INVALID VALUE FOR THIS ATTRIBUTE 


NON~NUMERIC VALUE IN SEQUENCE FIELD OF MERGE 
RECORD 


FILE IS NOT A VALID GEMCOS DEFINES FILE - <file 


name> 
MISSING DEFINE NAME 
INVALID DEFINE NAME 


DEFINE NOT FOUND IN DEFINES FILE 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


ERROR 


76:3 


77:3 


78: 


793 


80: 


81: 


82: 


83: 


84: 


85: 


86: 


87: 


88 


89: 


90: 


91 


92: 


93: 


94: 


95: 


96: 


97: 


98: 


99: 


INVALID INTEGER VALUE 


MISSING TOKEN 


STRING INVALID, 


UNBALANCED OR TOO LONG 


STRING EXPECTED 


TEST DATA TOO LARGE 


A data 


string was entered with the TESTIN 


Or 


TESTOUT command, but the string was too large for 


the 
with 


TEST 
TEST 
TEST 
TEST 
TEST 
TEST 


TEST 


format being tested. 


Re-enter the command 


a shorter data string. 


ERR, 
ERR, 
ERR, 
ERR, 
ERR, 
ERR, 


ERR, 


DEST PTR OUT OF BOUNDS 


SOURCE PTR OUT OF BOUNDS 


NON-DIGIT IN INTEGER FIELD 


MISSING SKIP DELIMITER 


VARIABLE REPEAT ON INPUT 


MISSING DELIMITER 


INVALID TRANSLATE FIELD 


INVALID FUNCTION IDENTIFIER 


EXPECTED 


MISSING KEYWORD ‘EXTERNAL’ 


MISSING KEYWORD 


' INTERNAL ' 


MISSING TRANSLATION LIST 


INVALID FUNCTION TYPE 


EXTERNAL STRING LENGTH MUST BE 


1 TO 6 CHARACTERS 


INTERNAL STRING LENGTH MUST BE 1 TO 6 CHARACTERS 


INCOMPLETE FUNCTION STATEMENT 


<control string> TOO LARGE TO TRANSLATE 


DEFINE NESTING LIMIT EXCEEDED 


SCREENSIZE LIMIT EXCEEDED - COMMAND NOT ACCEPTED 


A command has been entered that exceeds’ the 
screensize limit defined using the TERMINAL 
command. 7 


B - 10 


INDEX 


Alphanumeric data, 2-6, 4-5 

Ampersand (&), 4-5 

Application program, 2-6 

Attributes, setting, 5-32 

AUTCCOMPILE attribute, 5-3, 5-12, 5-35 


BYE command, 2-2, 3-2, 4-3, 5-2 
BYE PURGE command, 3-2 
BYE SAVE command, 3-2 


Characters, inserting, 4-5 

Character defines, 4-2 

CLEAR attribute, 4-4 

COBOL entries, 2-2 
library, 2-2, 3-6 

Commands terminating, 3-11 

COMPILE command, 4-14, 4-23, 5-3, 5-12 
update feature of, 4-22 

Control strings, 5-5 

CTRL Q, 2-10 


Data, 
displaying, 4-21, 5-10 
rearranging, 1-5 
translating, 1-4, 2-10 
Data fields, 
ending, 3-6 
starting, 3-6 
Data line, 5-19 
Data screens, receiving additional, 3-14 
Data strings, 1-5 
Data structures, 1-4, 1-5 
DEBUG command, 3-3, 5-4 
DEBUG option, setting, 5-4 
DEFINE command, 4-2, 5-5, 5-32 
Defines, 
adding, 5-6 
specifying, 5-6 
Defines file, 4-1, 4-2, 4-20, 5-6, 5-32 
creating, 5-32 
saving, 5-32 
DELETE command, 3-4, 5-8, 5-9 
Display. See Terminal display. 
DISPLAY command, 2-13, 3-5, 4-21, 5-6, 5-10 


Error messages. See Messages. 
Errors, finding, 5-35 
EX network control command, 2-2 


Expecting Format Layout mode, 2-4, 
3-11, 3-13, 3-16, 4-3, 4-6, 4- 
5-14, 5-17, 5-29, 5-30 


0-7, Deh, 326, 327, Se. 
7° S<105. 5211. 5<12- 


Field delimiters, 5-12 
deleting, 1-4 
inserting, 1-4, 1-5 
rearranging, 1-4 
repeating, 2-10 
replacing, 1-5 
Files, 
displaying, 5-23 
merging, 5-24, 5-27 
purging work, 2-1 | 
Format attributes, setting, 5-11 
modifying, 2-7 
FORMAT command, 2-5, 2-12, 2-14, 3-6, 3-7, 4-3, 4-4, 4-16, 
5-3, 5-10, 5-11, 5-15, 5-19 
Format files, 2-15, 3-9, 4-19, 5-36 
modifying, 2-14, 3-15 
opening, 3-15 
updating, 2-1 
Format Generator, 
commands, 5-1, 5-17, 5-31 
multiple copies, 4-3 
program, 1-3, 5-36 
Format Layout file, 4-1, 4-2, 4-3, 4-5, 4-16, 4-19, 4-21, 
5-10, 5-30 
displaying, 5-10, 4-21 
purging, 5-2 
removing information, 4-5 
| translating, 4-2 
Format layouts, 1-2, 2-13, 3-18, 4-19, 5-10, 5-14 
printing, 4-21 
translating, 5-35 
Format Maker, 
commands, 3-1, 3-10 
initiation, 2-15 
program, 1-5, 2-1, 2-2, 2-8, 3-6 
Format names, 3-6 
displaying, 3-12 
listing, 3-12 
Formats, 
access to updated, 2-14 
adding, 3-15 
changing, 2-7, 3-13 
compiling, 4-1, 4-16, 4-18, 5-3 
converting to format layout, 4-23 
creating, 2-5, 3-6, 4-3 
deleting, 3-4 
displaying, 2-7, 2-10, 2-12, 3-5, 3-9 
duplicating, 2-11 


inserting, 2-ll, 2-14, 3-19, 5-36 

laying out, 1-3, 2-5, 2-6, 2-7, 3-8, 4-3, 4-5, 5-15 

listing, 5-17 

modifying, 2-6, 2-13, 4-7, 4-22, 4-23, 5-15 

pre-designed, 1-5 

printing, 3-21, 5-39 

retrieving, 2-ll, 3-9, 4-19, 4-23, 5-15, 5-29 

sending, 2-6, 2-10, 3-18, 4-16, 4-18, 5-34 

transferring, 2-1, 2-6, 2-14, 4-1, 4-22, 4-23 

updating, 1-1, 2-13 
Formatting session, 2-1, 2-2, 

ending, 3-2, 4-2, 4-3, 5- 
Forms delimiter, 2-3 
FORMS mode, 2-3, 2-1 

entering, 5-5 

exiting, 2-10 
Forms request, 4-18 
FORMSMODE attribute, 4-4 
Functions, 4-2 

adding, 4-25 

compiling, 4-14 

declaring, 4-14 

inserting, 4-14 

syntax checking, 5-3 


4-1 
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GEMCOS control station, 2-14, 3-19, 5-36 

GEMCOS environment, 2-13, 5-12, 5-36 

GEMCOS format editing phrases, 5-34 

GEMCOS MCS, 1-1, 2-1, 2-2, 2-14, 2-15, 4-2, 4-23, 5-12 
GEMCOS network, 4-1, 4-22, 4-23 

GEMCOS output, 2-1 

GEMCOS TCL formatting codes, 4-1 

GET command, 2-11, 2-14, 3-9, 4-19, 5-15, 5-29 


Header records, modifying, 2-14 
HELP command, 3-10, 3-17, 5-1/7 


IGNORE command, 2-5, 2-7, 3-11, 3-13, 4-5, 5-17 
Information, 
displaying, 5-10, 5-23, 5-30, 5-31, 5-38 
obtaining format, 3-16 
obtaining command, 3-17 
Internal location pointer, 5-21 


LIBRARY attribute, 3 
Library file, 2-1, 2 
LINE command, 2-8, 4 
5-18, 5-35 

Lines, deleting, 5-9 
LIST command, 3-12, 4-24, 5-23, 5-25 
Literal expressions, insertion within, 5-18 
Literals, displaying, 4-21 
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Live Format file, 1-1, 2-14, 4-1, 4-2, 
creating, 2-15 
specifying, 3-19 
updating, 2-1 

Location specifiers, 2-10 


MCS. See GEMCOS MCS. 

MERGE command, 4-25, 5-24, 5-27 
Merge file, 5-32 

Message layout, 4-10 

Messages, 2-l1l 

MODIFY command, 2-7, 3-13 


4-19, 


4-22 


Noninterpretive format files. See Format files. 


Noninterpretive formats, 1-1 
Null input, 3-14, 5-25 
Numeric data, 4-5 


On-line Data Terminal (ODT), 5-36 
Op codes, 4-1 

OPEN command, 2-15, 3-15 

Output formats, 3-18 


Pound sign (#), 2-6, 4-5 

Printer file, writing to, 3-3, 5-4 
Programmer, 1-l, 1-3, 1-5, 2-2 
Protected data, 5-6 


Ranges, deleting, 5-9 
Records, 
adding, 4-25 
merging, 4-1, 4-25, 4-26 
modifying, 4-1 
Remapping, 4-12 
RESEQ command, 5-26 
RESIDENT attribute, 5-12 
RMERGE command, 4-25, 5-27 


SAVE command, 4-25, 5-28 

Saved files, merging, 4-26 

Screen, clearing, 4-3 

SCROLL mode, 2-2, 4-3 

SEQUENCE command, 4-14, 4-24, 5-29 

Session. See Formatting session. 

Source images, 4-2, 4-16, 4-19 
inserting, 5-29 


Status report, 3-16 


System Defines file. See Defines file. 


TCL functions, 5-15 
TCL source images. See Source images. 


5-12, 


TCL work file, 5-3, 5-8, 5-23, 5-24, 5-27, 5-29, 5-30, 
5-35, 5-39 
adding records, 4-23 
compiling, 4-16, 5-3 
deleting records, 4-23 
displaying records, 4-23, 4-24, 5-10 
modifying records, 4-23, 4-24 
purging, 4-2, 4-3, 4-26, 5-2 
removing, 5-9 
resequencing, 5-26 
Saving, 4-1, 4-2, 4-23, 4-26, 4-27, 5-14, 5-28 
TEACH command, 1-6, 3-10, 3-17, 5-17, 5-31 
TERMINAL command, 4-20, 5-6, 5-32 
Terminal display, 1-5, 2-4, 2-14 
TEST command, 2-10, 3-18, 4-18, 5-3, 5-34 
Test data, 3-18 
Test files, 3-12 
closing, 2-15, 3-15 
creating, 2-15 
naming, 2-15 
opening, 2-15 
purging, 2-15, 3-2, 3-15 
saving, 3-2, 3-15 
writing to printer, 3-21 
Test Format file, 1-1, 2-1, 2-2, 2-7, 2-15, 3-2, 3 
3-16, 4-1,4-2, 4-3, 4-16, 4-18, 4-19, 4-22, 5- 
5-15, 5-36 
opening, 2-15 
purging, 2-2, 4-3, 5-2 
Saving, 2-2 
Test message, 3-18 
TESTIN command. See TEST command. 
TESTOUT command. See TEST command. 
Text, displaying, 5-10 
Transaction Control Language work file. See TCL workfile. 
TRANSLATE command, 4-16, 5-12, 5-35 


UPD FORMATS command, 2-14 

UPD network command, 5-36 

UPDATE command, 2-14, 3-19, 4-22, 4-23, 5-2, 5-3, 5-36 
UPDATE mode, 3-19, 5-3, 5-36 


WHAT command, 1-6, 3-4, 3-7, 3-16, 3-20, 5-12, 5-30, 5-38 
Work files, 5-13, 5-26, 5-28 

saving, 2-1 
WRITE command, 2-3, 2-13, 3-21, 4-21, 5-39 


